IAppxPackageWriter::AddPayloadFile-Methode (appxpackaging.h)
Fügt dem App-Paket eine neue Nutzlastdatei hinzu.
Syntax
HRESULT AddPayloadFile(
[in] LPCWSTR fileName,
[in] LPCWSTR contentType,
[in] APPX_COMPRESSION_OPTION compressionOption,
[in] IStream *inputStream
);
Parameter
[in] fileName
Typ: LPCWSTR
Der Name der Nutzlastdatei. Der Dateinamepfad muss relativ zum Stammverzeichnis des Pakets sein.
[in] contentType
Typ: LPCWSTR
Die Zeichenfolge, die den Inhaltstyp von fileName angibt.
[in] compressionOption
Der Komprimierungstyp, der zum Speichern von fileName im Paket verwendet werden soll.
[in] inputStream
Typ: IStream*
Ein IStream , der den Inhalt von fileName bereitstellt. Der Stream muss Read, Seek und Stat unterstützen.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode zurückgegeben, der die Fehler in der folgenden Tabelle enthält, aber nicht beschränkt ist. Fehler bei OPC-Codes können zusätzlich zu OPC_E_DUPLICATE_PART auftreten. Wenn die Methode fehlschlägt, wird der Paketschreiber in einem fehlerhaften Zustand geschlossen und kann nicht mehr verwendet werden.
| Rückgabecode | Beschreibung |
|---|---|
|
Die von compressionOption angegebene Komprimierungsoption gehört nicht zu den Werten der APPX_COMPRESSION_OPTION-Enumeration . |
|
Der Writer ist geschlossen. |
|
Der angegebene Dateiname ist kein gültiger Dateiname oder ein reservierter Name für eine Footprintdatei. |
|
Der angegebene Dateiname wird bereits im Paket verwendet. |
Hinweise
Wenn die AddPayloadFile-Methode erfolgreich ist, wird der Inhalt der angegebenen dateiName in das Paket geschrieben, und ein entsprechender Eintrag wird in der Paketblockzuordnung vorgenommen.
AppxManifest.xml, AppxBlockMap.xml, AppxStreamMap.xml und AppxSignature.p7x.
Außerdem können Dateien mit den folgenden reservierten Ordnerpräfixen dem Paket nicht mithilfe der AddPayloadFile-Methode hinzugefügt werden: \AppxMetadata\ und \Microsoft.System.Package.Metadata\.
Beispiele
Ein Beispiel finden Sie unter Erstellen eines App-Pakets.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | appxpackaging.h |