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 |
|
| Biblioteca |
|
| DLL |
|