MrmDumpPriDataInMemory 関数

[一部の情報はリリース前の製品に関することであり、正式版がリリースされるまでに大幅に変更される可能性があります。 ここに記載された情報について、Microsoft は明示または黙示を問わずいかなる保証をするものでもありません。]

PRI 情報 ( MrmCreateResourceFileInMemory の以前の呼び出しによって作成されたメモリ内の BLOB として) を XML と同等の (メモリ内データとして) ダンプして、読みやすくします。 関数はメモリを割り当て、 outputXmlData 内のそのメモリへのポインターを返します。 同じポインターを使用して MrmFreeMemory を呼び出して、そのメモリを解放します。 これらの API の使用方法の詳細とシナリオベースのチュートリアルについては、「 パッケージ リソース インデックス作成 (PRI) API とカスタム ビルド システム」を参照してください。

構文

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
);

パラメーター

inputPriData [in]

型: BYTE*

MrmCreateResourceFileInMemory の前回の呼び出しによって作成された PRI データへのポインター。

inputPriSize [in]

種類: ULONG

inputPriData が指すデータのサイズ。

schemaPriData [in, optional]

型: BYTE*

MrmCreateResourceFileInMemory の以前の呼び出しによって作成されたスキーマ データを表す PRI 情報 (メモリ内の BLOB として) へのオプションのポインター。 リソース インデクサーの使用が完了するまで schemaPriData を解放しないでください。 「解説」も参照してください。

schemaPriSize [in]

種類: ULONG

schemaPriData が指すデータのサイズ。

dumpType [in]

型: MrmDumpType

XML ダンプの詳細を指定するか、スキーマをダンプするかどうかを指定します。

outputXmlData [out]

型: BYTE**

BYTE へのポインターのアドレス。 関数はメモリを割り当て、 outputXmlData 内のそのメモリへのポインターを返します。 そのメモリを解放するには、BYTE へのポインターを使用して MrmFreeMemory を呼び出します。

outputXmlSize [out]

種類: ULONG*

ULONG のアドレス。 outputXmlSize では、関数は outputXmlData が指す割り当てられたメモリのサイズを返します。

戻り値

型: HRESULT

関数が成功した場合はS_OK。それ以外の場合は値。 成功または失敗を判断するには、SUCCEEDED() または FAILED() マクロ (winerror.h で定義) を使用します。

注釈

スキーマフリー リソース パックは、MrmPackagingOptionsOmitSchemaFromResourcePacks 引数を MrmCreateResourceFile または MrmCreateResourceFileInMemory に渡して作成したものです (または PRI 構成ファイルの omitSchemaFromResourcePacks スイッチを使用)。 スキーマのないリソース パックをダンプするには、schemaPriData パラメーターの引数として、メイン パッケージ PRI データへのパスを渡します。

要件

要件	値
サポートされている最小のクライアント	Windows 10バージョン 1803 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server [デスクトップ アプリのみ]
Header	MrmResourceIndexer.h
ライブラリ	Mrmsupport.lib
[DLL]	Mrmsupport.dll

関連項目

パッケージ リソース インデックス (PRI) API とカスタム ビルド システム