Metodo IAppxPackageWriter::AddPayloadFile (appxpackaging.h)

Articolo
08/22/2023

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
E_INVALIDARG	L'opzione di compressione specificata da compressionOption non è uno dei valori dell'enumerazione APPX_COMPRESSION_OPTION .
E_NOT_VALID_STATE	Il writer viene chiuso.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)	Il nome del file specificato non è un nome file valido o è un nome riservato per un file di footprint.
OPC_E_DUPLICATE_PART	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.

Nota I file con i seguenti nomi di file riservati non possono essere aggiunti al pacchetto usando il metodo AddPayloadFile :

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

Vedi anche

APPX_COMPRESSION_OPTION

IAppxPackageWriter

Share via