Função MrmDumpPriDataInMemory
[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 informações pri (como um blob na memória, criada por uma chamada anterior para MrmCreateResourceFileInMemory) para 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 MrmDumpPriDataInMemory(
_In_ BYTE *inputPriData,
_In_ ULONG inputPriSize,
_In_opt_ BYTE *schemaPriData,
_In_ ULONG schemaPriSize,
_In_ MrmDumpType dumpType,
_Out_ BYTE **outputXmlData,
_Out_ ULONG *outputXmlSize
);
Parâmetros
-
inputPriData [in]
-
Tipo: BYTE*
Um ponteiro para dados PRI criados por uma chamada anterior para MrmCreateResourceFileInMemory.
-
inputPriSize [in]
-
Tipo: ULONG
O tamanho dos dados apontados por inputPriData.
-
schemaPriData [in, opcional]
-
Tipo: BYTE*
Um ponteiro opcional para informações pri (como um blob na memória) que representa os dados de esquema criados por uma chamada anterior para MrmCreateResourceFileInMemory. Não libere schemaPriData até terminar de usar o indexador de recursos. Consulte também Comentários.
-
schemaPriSize [in]
-
Tipo: ULONG
O tamanho dos dados apontados por schemaPriData.
-
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 tiver sido 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 os dados pri do pacote main como o argumento para o parâmetro schemaPriData.
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 |
|