Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PRESUTIL_DUP_PARAMETER_BLOCK

PRESUTIL_DUP_PARAMETER_BLOCK

コールバック

シグネチャ

DWORD PRESUTIL_DUP_PARAMETER_BLOCK(
    BYTE* pOutParams,
    BYTE* pInParams,
    RESUTIL_PROPERTY_ITEM* pPropertyTable
);

パラメーター

フィールド型説明
pOutParamsBYTE*複製先のパラメーターブロックへのポインターです。
pInParamsBYTE*元のパラメーターブロックへのポインターです。
pPropertyTableRESUTIL_PROPERTY_ITEM*元のパラメーターブロック内のプロパティを記述する RESUTIL_PROPERTY_ITEM 構造体の配列へのポインターです。

公式ドキュメント

あるパラメーターブロックから別の パラメーターブロック へ、メンバー単位でデータをコピーします。

戻り値

処理に成功すると、この関数は ERROR_SUCCESS を返します。

処理に失敗すると、 この関数は システムエラーコード を返します。

解説(Remarks)

ResUtilDupParameterBlock は、入力パラメーター pPropertyTable で参照されているパラメーターブロックのメンバーについてのみデータをコピーします。入力パラメーターブロック内の変数がポインターである場合、そのデータ用のメモリは LocalAlloc 関数で割り当てられます。このメモリは、出力パラメーターブロック内の各ポインター変数に対して LocalFree を呼び出すか、または ResUtilFreeParameterBlock を呼び出して解放してください。ResUtilDupParameterBlock が成功した場合でも失敗した場合でも、必ずメモリを解放するようにしてください。詳細については、Using Parameter Blocks および Using Lists and Tables を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)