共用方式為


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 參數。 請注意,當 hSelfhEnum 參考相同的資源時,永遠不會呼叫回調函式。

hEnum

目前正在列舉之資源的句柄。 ResUtilEnumResourcesEx 隨即 開啟,並自動關閉此句柄。

pParameter

泛型緩衝區,可讓您將任何類型的數據傳遞至回調函式。

[in] pParameter

泛型緩衝區,可讓您將任何類型的數據傳遞至回調函式。 ResUtilEnumResourcesEx 完全不使用此參數;它只會將指標傳遞至回調函式。 您是否可以傳遞參數的 NULL ,取決於回呼函式的實作方式。

傳回值

如果作業成功,函式會 傳回ERROR_SUCCESS

如果作業失敗,函式會立即停止列舉,並傳回回調函式所傳回的值。

備註

ResUtilEnumResourcesExClusterResourceEnum 函式的方便且易於使用的替代方案。

範例

請參閱 ResUtilEnumResources 的範例。

規格需求

需求
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 Datacenter、Windows Server 2008 Enterprise
目標平台 Windows
標頭 resapi.h
程式庫 ResUtils.lib
Dll ResUtils.dll

另請參閱

ClusterResourceEnum

ResUtilEnumResources

ResourceCallbackEx