Metodo IAppxPackageWriter::AddPayloadFile (appxpackaging.h)
Aggiunge un nuovo file payload al pacchetto dell'app.
Sintassi
HRESULT AddPayloadFile(
[in] LPCWSTR fileName,
[in] LPCWSTR contentType,
[in] APPX_COMPRESSION_OPTION compressionOption,
[in] IStream *inputStream
);
Parametri
[in] fileName
Tipo: LPCWSTR
Nome del file payload. Il percorso del nome file deve essere relativo alla radice del pacchetto.
[in] contentType
Tipo: LPCWSTR
Stringa che specifica il tipo di contenutofileName.
[in] compressionOption
Tipo: APPX_COMPRESSION_OPTION
Tipo di compressione da usare per archiviare fileName nel pacchetto.
[in] inputStream
Tipo: IStream*
IStream che fornisce il contenuto di fileName. Il flusso deve supportare Read, Seek e Stat.
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore che include, ma non è limitato a, quelli nella tabella seguente. I codici OPC di errore, oltre a OPC_E_DUPLICATE_PART possono risultare. Se il metodo ha esito negativo, il writer del pacchetto chiuderà in uno stato non riuscito e non può più essere usato.
Codice restituito | Descrizione |
---|---|
|
L'opzione di compressione specificata da compressionOption non è uno dei valori dell'enumerazione APPX_COMPRESSION_OPTION . |
|
Il writer viene chiuso. |
|
Il nome del file specificato non è un nome file valido o è un nome riservato per un file di footprint. |
|
Il nome del file specificato è già in uso nel pacchetto. |
Commenti
Quando il metodo AddPayloadFile ha esito positivo sul contenuto del fileName specificato viene scritto nel pacchetto e viene eseguita una voce corrispondente nella mappa dei blocchi del pacchetto.
AppxManifest.xml
, AppxBlockMap.xml
, AppxStreamMap.xml
e AppxSignature.p7x
.
Inoltre, i file con i prefissi di cartelle riservate seguenti non possono essere aggiunti al pacchetto usando il metodo AddPayloadFile : \AppxMetadata\
e \Microsoft.System.Package.Metadata\
.
Esempio
Per un esempio, vedere Come creare un pacchetto di app.
Requisiti
Client minimo supportato | Windows 8 [solo app desktop] |
Server minimo supportato | Windows Server 2012 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | appxpackaging.h |