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

PRESUTIL_ENUM_RESOURCES_EX2

コールバック

シグネチャ

DWORD PRESUTIL_ENUM_RESOURCES_EX2(
    HCLUSTER hCluster,
    HRESOURCE hSelf,
    LPWSTR lpszResTypeName,
    LPRESOURCE_CALLBACK_EX pResCallBack,
    void* pParameter,
    DWORD dwDesiredAccess
);

パラメーター

フィールド型説明
hClusterHCLUSTER列挙するリソースを含むクラスターへのハンドルです。
hSelfHRESOURCEクラスターリソースへの省略可能なハンドルです。hSelf で指定されたリソースに対しては、コールバック関数は呼び出されません。
lpszResTypeNameLPWSTR列挙するリソースの範囲を絞り込む リソースの種類 の名前への 省略可能なポインターです。lpszResTypeName を指定した場合、指定した種類のリソースだけが列挙されます。
pResCallBackLPRESOURCE_CALLBACK_EX

列挙された各リソースに対して呼び出されるユーザー定義関数へのポインターです。この関数は ResourceCallbackEx コールバック関数の 定義に従う必要があります(引数名は定義の一部ではなく、ここでは分かりやすさのために付けたものです):

DWORD (*LPRESOURCE_CALLBACK_EX)( 
  HCLUSTER hCluster,
  HRESOURCE hSelf, 
  HRESOURCE hEnum, 
  PVOID pParameter 
);

hCluster

[in] ResUtilEnumResourcesEx に渡された hCluster パラメーターです。

hSelf

[in] ResUtilEnumResourcesEx に渡された hSelf パラメーターです。hSelf と hEnum が同じリソースを指す場合、 コールバック関数は呼び出されないことに注意してください。

hEnum

[in] 現在列挙中のリソースへのハンドルです。 ResUtilEnumResourcesEx が、このハンドルを 自動的に開いて閉じます。

pParameter

[in] 任意の種類のデータをコールバック関数に渡すための汎用バッファーです。

pParametervoid*任意の種類のデータをコールバック関数に渡すための汎用バッファーです。 ResUtilEnumResourcesEx はこのパラメーターを まったく使用せず、ポインターをコールバック関数に渡すだけです。このパラメーターに NULL を渡せるかどうかは、コールバック関数の実装方法によります。
dwDesiredAccessDWORD要求するアクセス権限です。GENERIC_READ (0x80000000)、GENERIC_ALL (0x10000000)、MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせを指定できます。この値が 0 の場合、未定義のエラーが返されることがあります。GENERIC_ALL を使用することは、ResUtilEnumResourcesEx を呼び出すことと同じです。

公式ドキュメント

指定した クラスター 内のすべての リソース を列挙し、各リソースに対して ユーザー定義の操作を開始します。PRESUTIL_ENUM_RESOURCES_EX2 型は、この関数へのポインターを定義します。

戻り値

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

操作が失敗した場合、関数は直ちに列挙を中止し、 コールバック関数が返した値を返します。

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