Funzione MrmDumpPriFileInMemory

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.

Esegue il dump di un file PRI (che è binario) nell'equivalente XML (come dati in memoria), per renderlo più facilmente leggibile. La funzione alloca la memoria e restituisce un puntatore a tale memoria in outputXmlData. Chiama MrmFreeMemory con lo stesso puntatore per liberare tale memoria. Per altre info e procedure dettagliate basate su scenari su come usare queste API, vedere API di indicizzazione delle risorse del pacchetto (PRI) e sistemi di compilazione personalizzati.

Sintassi

HRESULT HRESULT MrmDumpPriFileInMemory(
  _In_     PCWSTR      indexFileName,
  _In_opt_ PCWSTR      schemaPriFile,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

Parametri

indexFileName [in]

Tipo: PCWSTR

Percorso completo di un file PRI. Si tratta del file PRI che verrà sottoposto a dump in XML.

schemaPriFile [in, facoltativo]

Tipo: PCWSTR

Percorso di file completo facoltativo in un file di schema (o in un file PRI che rappresenta uno schema; vedere Osservazioni).

dumpType [in]

Tipo: MrmDumpType

Specifica il modo in cui deve essere dettagliato il dump XML o se è necessario eseguire il dump di uno schema.

outputXmlData [out]

Tipo: BYTE**

Indirizzo di un puntatore a BYTE. La funzione alloca la memoria e restituisce un puntatore a tale memoria in outputXmlData. Chiama MrmFreeMemory con il puntatore a BYTE per liberare tale memoria.

outputXmlSize [out]

Tipo: ULONG*

Indirizzo di una ULONG. In outputXmlSize la funzione restituisce le dimensioni della memoria allocata a cui punta outputXmlData.

Valore restituito

Tipo: HRESULT

S_OK se la funzione ha avuto esito positivo; in caso contrario, un altro valore. Utilizzare le macro SUCCEEDED() o FAILED() (definite in winerror.h) per determinare l'esito positivo o negativo.

Commenti

Un pacchetto di risorse senza schema è uno creato con l'argomento MrmPackagingOptionsOmitSchemaFromResourcePacks passato all'argomento MrmCreateResourceFile o MrmCreateResourceFileInMemory (o con l'opzione omitSchemaFromResourcePacks nel file di configurazione PRI). Per eseguire il dump di un pacchetto di risorse senza schema, passare il percorso ai dati PRI del pacchetto principale come argomento per il parametro schemaPriFile .

Requisiti

Vedi anche

API per l'indicizzazione delle risorse del pacchetto e sistemi di compilazione personalizzati