ResUtilEnumResourcesEx2 函式 (resapi.h)

發行項
03/01/2024

列舉指定叢集中的所有資源，併為每個資源起始使用者定義的作業。 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

[in]傳遞至 ResUtilEnumResourcesEx 的 hCluster 參數。

hSelf

[in]傳遞至 ResUtilEnumResourcesEx 的 hSelf 參數。請注意，當 hSelf 和 hEnum 參考相同的資源時，永遠不會呼叫回調函式。

hEnum

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

pParameter

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

[in] pParameter

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

[in] dwDesiredAccess

要求的存取許可權。這可能是 GENERIC_READ (0x80000000) 、 GENERIC_ALL (0x10000000) 或 MAXIMUM_ALLOWED (0x02000000) 的任何組合。如果此值為零 (0) ，可能會傳回未定義的錯誤。使用 GENERIC_ALL 與呼叫 ResUtilEnumResourcesEx 相同。

傳回值

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

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

規格需求

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

另請參閱

資源公用程式函式

共用方式為