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 |
|
ライブラリ |
|
[DLL] |
|