MrmDumpPriFileInMemory 関数

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

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

構文

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

パラメーター

indexFileName [in]

種類: PCWSTR

PRI ファイルへの完全なファイル パス。 これは、XML にダンプされる PRI ファイルです。

schemaPriFile [in, optional]

種類: PCWSTR

スキーマ ファイル (またはスキーマを表す PRI ファイル) へのオプションの完全なファイル パス。「解説」を参照してください。

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 スイッチを使用)。 スキーマのないリソース パックをダンプするには、schemaPriFile パラメーターの引数として、メイン パッケージ PRI データへのパスを渡します。

要件

関連項目

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