1 files changed, 93 insertions, 0 deletions

diff --git a/src/engine/payload.h b/src/engine/payload.h
new file mode 100644
index 00000000..0c7b68e4
--- /dev/null
+++ b/src/engine/payload.h
@@ -0,0 +1,93 @@
+#pragma once
+// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
+
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+
+// constants
+
+enum BURN_PAYLOAD_PACKAGING
+{
+    BURN_PAYLOAD_PACKAGING_NONE,
+    BURN_PAYLOAD_PACKAGING_DOWNLOAD,
+    BURN_PAYLOAD_PACKAGING_EMBEDDED,
+    BURN_PAYLOAD_PACKAGING_EXTERNAL,
+};
+
+enum BURN_PAYLOAD_STATE
+{
+    BURN_PAYLOAD_STATE_NONE,
+    BURN_PAYLOAD_STATE_ACQUIRED,
+    BURN_PAYLOAD_STATE_CACHED,
+};
+
+
+// structs
+
+typedef struct _BURN_PAYLOAD
+{
+    LPWSTR sczKey;
+    BURN_PAYLOAD_PACKAGING packaging;
+    BOOL fLayoutOnly;
+    DWORD64 qwFileSize;
+    LPWSTR sczFilePath; // file path relative to the execute location
+
+    BURN_CATALOG *pCatalog; // used to verify this payload
+    BYTE* pbCertificateRootPublicKeyIdentifier;
+    DWORD cbCertificateRootPublicKeyIdentifier;
+    BYTE* pbCertificateRootThumbprint;
+    DWORD cbCertificateRootThumbprint;
+    BYTE* pbHash;
+    DWORD cbHash;
+
+    LPWSTR sczSourcePath;
+    BURN_CONTAINER* pContainer;
+    DOWNLOAD_SOURCE downloadSource;
+
+    // mutable members
+    BURN_PAYLOAD_STATE state;
+    LPWSTR sczLocalFilePath; // location of extracted or downloaded copy
+} BURN_PAYLOAD;
+
+typedef struct _BURN_PAYLOADS
+{
+    BURN_PAYLOAD* rgPayloads;
+    DWORD cPayloads;
+} BURN_PAYLOADS;
+
+
+// functions
+
+HRESULT PayloadsParseFromXml(
+    __in BURN_PAYLOADS* pPayloads,
+    __in_opt BURN_CONTAINERS* pContainers,
+    __in_opt BURN_CATALOGS* pCatalogs,
+    __in IXMLDOMNode* pixnBundle
+    );
+void PayloadsUninitialize(
+    __in BURN_PAYLOADS* pPayloads
+    );
+HRESULT PayloadExtractFromContainer(
+    __in BURN_PAYLOADS* pPayloads,
+    __in_opt BURN_CONTAINER* pContainer,
+    __in BURN_CONTAINER_CONTEXT* pContainerContext,
+    __in_z LPCWSTR wzTargetDir
+    );
+HRESULT PayloadFindById(
+    __in BURN_PAYLOADS* pPayloads,
+    __in_z LPCWSTR wzId,
+    __out BURN_PAYLOAD** ppPayload
+    );
+HRESULT PayloadFindEmbeddedBySourcePath(
+    __in BURN_PAYLOADS* pPayloads,
+    __in_z LPCWSTR wzStreamName,
+    __out BURN_PAYLOAD** ppPayload
+    );
+
+
+#if defined(__cplusplus)
+}
+#endif