Funzione MrmDumpPriDataInMemory

[Alcune informazioni si riferiscono al prodotto pre-rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non offre garanzie, esplicite o implicite, rispetto alle informazioni fornite qui.

Dumps PRI info (come BLOB in memoria, creato da una chiamata precedente a MrmCreateResourceFileInMemory) al relativo equivalente XML (come dati in memoria), per renderlo più leggibile. La funzione alloca la memoria e restituisce un puntatore a tale memoria in outputXmlData. Chiamare MrmFreeMemory con lo stesso puntatore per liberare tale memoria. Per altre informazioni e procedure dettagliate basate su scenari su come usare queste API, vedere API di indicizzazione delle risorse del pacchetto e sistemi di compilazione personalizzati.

Sintassi

HRESULT HRESULT MrmDumpPriDataInMemory(
  _In_     BYTE        *inputPriData,
  _In_     ULONG       inputPriSize,
  _In_opt_ BYTE        *schemaPriData,
  _In_     ULONG       schemaPriSize,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

Parametri

inputPriData [in]

Tipo: BYTE*

Puntatore ai dati PRI creati da una chiamata precedente a MrmCreateResourceFileInMemory.

inputPriSize [in]

Tipo: ULONG

Dimensioni dei dati a cui punta inputPriData.

schemaPriData [in, facoltativo]

Tipo: BYTE*

Puntatore facoltativo a informazioni PRI (come BLOB in memoria) che rappresentano i dati dello schema creati da una chiamata precedente a MrmCreateResourceFileInMemory. Non liberare schemaPriData fino al termine dell'uso dell'indicizzatore di risorse. Vedere anche Osservazioni.

schemaPriSize [in]

Tipo: ULONG

Dimensioni dei dati a cui punta schemaPriData.

dumpType [in]

Tipo: MrmDumpType

Specifica il modo in cui deve essere specificato 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. Chiamare MrmFreeMemory con il puntatore a BYTE per liberare tale memoria.

outputXmlSize [out]

Tipo: ULONG*

Indirizzo di un ULONG. In outputXmlSize la funzione restituisce le dimensioni della memoria allocata a cui fa riferimento outputXmlData.

Valore restituito

Tipo: HRESULT

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

Commenti

Un resource pack 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 Resource Pack senza schema, passare il percorso ai dati PRI del pacchetto principale come argomento per il parametro schemaPriData .

Requisiti

Vedi anche

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