ResUtilEnumResourcesEx 関数 (resapi.h)
指定したクラスター内のすべてのリソースを列挙し、各リソースのユーザー定義操作を開始します。 PRESUTIL_ENUM_RESOURCES_EX型は、この関数へのポインターを定義します。
構文
DWORD ResUtilEnumResourcesEx(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter
);
パラメーター
[in] hCluster
列挙するリソースを含むクラスターへのハンドル。
[in, optional] hSelf
クラスター リソースへの省略可能なハンドル。 コールバック関数は、 hSelf によって識別されるリソースに対して呼び出されません。
[in] lpszResTypeName
列挙するリソースのスコープを絞り込む リソースの種類 の名前への省略可能なポインター。 lpszResTypeName を指定した場合、指定した型のリソースのみが列挙されます。
[in] pResCallBack
列挙された各リソースに対して呼び出されるユーザー定義関数へのポインター。 この関数は 、ResourceCallbackEx コールバック関数の定義に準拠している必要があります。 パラメーター名は定義の一部ではないことに注意してください。これらはわかりやすくするためにここに追加されています。
DWORD (*LPRESOURCE_CALLBACK_EX)(
HCLUSTER hCluster,
HRESOURCE hSelf,
HRESOURCE hEnum,
PVOID pParameter
);
hCluster
ResUtilEnumResourcesEx に渡される hCluster パラメーター。
hSelf
ResUtilEnumResourcesEx に渡される hSelf パラメーター。 hSelf と hEnum が同じリソースを参照している場合、コールバック関数は呼び出されません。
hEnum
現在列挙されているリソースへのハンドル。 ResUtilEnumResourcesEx は、このハンドルを自動的に開いて閉じます。
pParameter
任意の種類のデータをコールバック関数に渡すジェネリック バッファー。
[in] pParameter
任意の種類のデータをコールバック関数に渡すジェネリック バッファー。 ResUtilEnumResourcesEx では、このパラメーターはまったく使用されません。これは、単にコールバック関数へのポインターを渡すだけです。 パラメーターに NULL を 渡すことができるかどうかは、コールバック関数の実装方法によって異なります。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は列挙を直ちに停止し、コールバック関数によって返される値を返します。
注釈
ResUtilEnumResourcesEx は、 ClusterResourceEnum 関数に代わる便利で使いやすい代替手段です。
例
ResUtilEnumResources の例を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Datacenter、Windows Server 2008 Enterprise |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |