Função MrmDumpPriFileInMemory

[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]

Despeja um arquivo PRI (que é binário) em seu equivalente XML (como dados na memória), a fim de torná-lo mais facilmente legível. A função aloca memória e retorna um ponteiro para essa memória em outputXmlData. Chame MrmFreeMemory com o mesmo ponteiro para liberar essa memória. Para obter mais informações e instruções passo a passo baseadas em cenários de como usar essas APIs, consulte APIs pri (indexação de recursos de pacote) e sistemas de build personalizados.

Sintaxe

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

Parâmetros

indexFileName [in]

Tipo: PCWSTR

Um caminho de arquivo completo para um arquivo PRI. Este é o arquivo PRI que será despejado em XML.

schemaPriFile [in, opcional]

Tipo: PCWSTR

Um caminho de arquivo completo opcional para um arquivo de esquema (ou para um arquivo PRI que representa um esquema; consulte Comentários).

dumpType [in]

Tipo: MrmDumpType

Especifica o quão detalhado deve ser o despejo XML ou se um esquema deve ser despejado.

outputXmlData [out]

Tipo: BYTE**

O endereço de um ponteiro para BYTE. A função aloca memória e retorna um ponteiro para essa memória em outputXmlData. Chame MrmFreeMemory com o ponteiro para BYTE para liberar essa memória.

outputXmlSize [out]

Tipo: ULONG*

O endereço de um ULONG. Em outputXmlSize, a função retorna o tamanho da memória alocada apontada por outputXmlData.

Valor retornado

Tipo: HRESULT

S_OK se a função foi bem-sucedida, caso contrário, algum outro valor. Use as macros SUCCEEDED() ou FAILED() (definidas em winerror.h) para determinar o êxito ou a falha.

Comentários

Um pacote de recursos sem esquema é aquele que foi criado com o argumento MrmPackagingOptionsOmitSchemaFromResourcePacks passado para MrmCreateResourceFile ou MrmCreateResourceFileInMemory (ou com a opção omitSchemaFromResourcePacks no arquivo de configuração PRI). Para despejar um pacote de recursos sem esquema, passe o caminho para o main empacotar dados PRI como o argumento para o parâmetro schemaPriFile.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1803 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server [somente aplicativos da área de trabalho]
Cabeçalho	MrmResourceIndexer.h
Biblioteca	Mrmsupport.lib
DLL	Mrmsupport.dll

Confira também

APIs de PRI (índice de recurso do pacote) e sistemas de build personalizados