ResUtilEnumResourcesEx2 関数 (resapi.h)
指定したクラスター内のすべてのリソースを列挙し、各リソースのユーザー定義操作を開始します。 PRESUTIL_ENUM_RESOURCES_EX2型は、この関数へのポインターを定義します。
構文
DWORD ResUtilEnumResourcesEx2(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter,
[in] DWORD dwDesiredAccess
);
パラメーター
[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 を 渡すことができるかどうかは、コールバック関数の実装方法によって異なります。
[in] dwDesiredAccess
要求されたアクセス特権。 これは、 GENERIC_READ (0x80000000 )、GENERIC_ALL ( 0x10000000 )、または MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせです。 この値が 0 (0) の場合は、未定義のエラーが返される可能性があります。 GENERIC_ALLの使用は、ResUtilEnumResourcesEx の呼び出しと同じです。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は列挙を直ちに停止し、コールバック関数によって返される値を返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |