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 |
程式庫 | ResUtils.lib |
Dll | ResUtils.dll |