Fonction MrmDumpPriFileInMemory

Article
06/13/2023

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

Vide un fichier PRI (qui est binaire) sur son équivalent XML (sous forme de données en mémoire), afin de le rendre plus facilement lisible. La fonction alloue de la mémoire et retourne un pointeur vers cette mémoire dans outputXmlData. Appelez MrmFreeMemory avec le même pointeur pour libérer cette mémoire. Pour plus d’informations et des procédures pas à pas basées sur des scénarios sur l’utilisation de ces API, consultez API d’indexation des ressources de package (PRI) et systèmes de génération personnalisés.

Syntaxe

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

Paramètres

indexFileName [in]

Type : PCWSTR

Chemin d’accès complet à un fichier PRI. Il s’agit du fichier PRI qui sera vidé dans xml.

schemaPriFile [in, facultatif]

Type : PCWSTR

Chemin d’accès de fichier complet facultatif à un fichier de schéma (ou à un fichier PRI représentant un schéma ; voir Remarques).

dumpType [in]

Type : MrmDumpType

Spécifie le niveau de détail du vidage XML ou si un schéma doit être vidé.

outputXmlData [out]

Type : BYTE**

Adresse d’un pointeur vers BYTE. La fonction alloue de la mémoire et retourne un pointeur vers cette mémoire dans outputXmlData. Appelez MrmFreeMemory avec votre pointeur vers BYTE pour libérer cette mémoire.

outputXmlSize [out]

Type : ULONG*

Adresse d’un ULONG. Dans outputXmlSize, la fonction retourne la taille de la mémoire allouée pointée par outputXmlData.

Valeur retournée

Type : HRESULT

S_OK si la fonction a réussi, sinon une autre valeur. Utilisez les macros SUCCEEDED() ou FAILED() (définies dans winerror.h) pour déterminer la réussite ou l’échec.

Notes

Un pack de ressources sans schéma est celui qui a été créé avec l’argument MrmPackagingOptionsOmitSchemaFromResourcePacks passé à MrmCreateResourceFile ou MrmCreateResourceFileInMemory (ou avec le commutateur omitSchemaFromResourcePacks dans le fichier de configuration PRI). Pour vider un pack de ressources sans schéma, passez le chemin d’accès aux données PRI de votre package main comme argument du paramètre schemaPriFile.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1803 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server [applications de bureau uniquement]
En-tête	MrmResourceIndexer.h
Bibliothèque	Mrmsupport.lib
DLL	Mrmsupport.dll

Voir aussi

API d’indexation de ressources de package (IRP) et systèmes de génération personnalisés

Partager via