Función MrmDumpPriFileInMemory

[Parte de la información hace referencia a la versión preliminar del producto, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí].

Volca un archivo PRI (que es binario) en su equivalente XML (como datos en memoria), para que sea más fácil de leer. La función asigna memoria y devuelve un puntero a esa memoria en outputXmlData. Llame a MrmFreeMemory con el mismo puntero para liberar esa memoria. Para obtener más información y tutoriales basados en escenarios sobre cómo usar estas API, consulte Api de indexación de recursos de paquetes (PRI) y sistemas de compilación personalizados.

Sintaxis

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

Ruta de acceso de archivo completa a un archivo PRI. Este es el archivo PRI que se volcará en XML.

schemaPriFile [in, opcional]

Tipo: PCWSTR

Una ruta de acceso de archivo completa opcional a un archivo de esquema (o a un archivo PRI que representa un esquema; vea Comentarios).

dumpType [in]

Tipo: MrmDumpType

Especifica cómo se debe detallar el volcado xml o si se debe volcar un esquema.

outputXmlData [out]

Tipo: BYTE**

Dirección de un puntero a BYTE. La función asigna memoria y devuelve un puntero a esa memoria en outputXmlData. Llame a MrmFreeMemory con el puntero a BYTE para liberar esa memoria.

outputXmlSize [out]

Tipo: ULONG*

Dirección de un ULONG. En outputXmlSize, la función devuelve el tamaño de la memoria asignada a la que apunta outputXmlData.

Valor devuelto

Tipo: HRESULT

S_OK si la función se realizó correctamente; de lo contrario, algún otro valor. Use las macros SUCCEEDED() o FAILED() (definidas en winerror.h) para determinar el éxito o el error.

Comentarios

Un paquete de recursos sin esquema es uno que se creó con el argumento MrmPackagingOptionsOmitSchemaFromResourcePacks pasado a MrmCreateResourceFile o MrmCreateResourceFileInMemory (o con el modificador omitSchemaFromResourcePacks en el archivo de configuración PRI). Para volcar un paquete de recursos sin esquemas, pase la ruta de acceso a los datos pri del paquete principal como argumento para el parámetro schemaPriFile .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1803 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server [solo aplicaciones de escritorio]
Encabezado	MrmResourceIndexer.h
Biblioteca	Mrmsupport.lib
Archivo DLL	Mrmsupport.dll

Consulte también

API de indexación de recursos de paquetes (PRI) y sistemas de compilación personalizados