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

PRESUTIL_ENUM_RESOURCES_EX

コールバック

シグネチャ

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

パラメーター

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

列挙されたリソースごとに呼び出される、ユーザー定義の関数へのポインターです。この関数は ResourceCallbackEx コールバック関数の定義に 従う必要があります。なお、パラメーター名は定義の一部ではありません。ここでは分かりやすくするために付けています。

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

hCluster

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

hSelf

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

hEnum

現在列挙されているリソースのハンドルです。このハンドルは ResUtilEnumResourcesEx が自動的に オープンおよびクローズします。

pParameter

任意の種類のデータをコールバック関数に渡せる汎用のバッファーです。

pParametervoid*任意の種類のデータをコールバック関数に渡せる汎用のバッファーです。 ResUtilEnumResourcesEx はこのパラメーターを まったく使用せず、ポインターをコールバック関数にそのまま渡すだけです。このパラメーターに NULL を渡せるかどうかは、コールバック関数の実装方法によって決まります。

公式ドキュメント

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

戻り値

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

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

解説(Remarks)

ResUtilEnumResourcesEx は、 ClusterResourceEnum 関数に代わる、便利で 使いやすい手段です。

Examples

ResUtilEnumResources の例を 参照してください。

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