ホーム › Networking.Clustering › PRESOURCE_TYPE_CONTROL_ROUTINE

PRESOURCE_TYPE_CONTROL_ROUTINE

コールバック

シグネチャ

DWORD PRESOURCE_TYPE_CONTROL_ROUTINE(
    LPWSTR ResourceTypeName,
    DWORD ControlCode,
    void* InBuffer,
    DWORD InBufferSize,
    void* OutBuffer,
    DWORD OutBufferSize,
    DWORD* BytesReturned
);

パラメーター

フィールド	型	説明
ResourceTypeName	LPWSTR	操作の対象となるリソースの種類です。
ControlCode	DWORD	実行する操作を表す制御コードです。ControlCode パラメーターに指定できる有効な値の一覧については、Resource Type Control Codes を参照してください。
InBuffer	void*	操作で使用するデータが格納されたバッファーへのポインターです。操作がデータを必要としない場合、InBuffer は NULL でもかまいません。
InBufferSize	DWORD	InBuffer が指すバッファーのサイズ (バイト単位) です。
OutBuffer	void*	操作の結果として得られるデータを格納するバッファーへのポインターです。操作がデータを返さない場合、OutBuffer は NULL でもかまいません。
OutBufferSize	DWORD	OutBuffer が指す使用可能な領域のサイズ (バイト単位) です。
BytesReturned	DWORD*	OutBuffer が指すバッファーのうち、実際にデータが格納されているバイト数です。

公式ドキュメント

リソースの種類に適用される操作を実行します。PRESOURCE_TYPE_CONTROL_ROUTINE 型は、この関数へのポインターを定義します。

戻り値

操作が成功した場合、この関数は ERROR_SUCCESS を返します。

操作が失敗した場合、この関数はシステムエラーコードを返します。返される可能性のあるエラーコードを次に示します。

戻り値	説明
ERROR_INVALID_FUNCTION	リソース DLL が、ControlCode に対して DLL 側で行う処理 (ある場合) に加えて、リソースモニターによる既定の処理 (ある場合) を実行するよう要求しました。

解説(Remarks)

一部の制御コードはリソース DLL で処理すべきであり、それ以外はリソースモニターに任せるべきです。ResourceTypeControl エントリポイント関数の効果的な実装方法については、Implementing ResourceTypeControl を参照してください。

例

Resource DLL Examples を参照してください。

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