ClusterResourceTypeEnum 函式 (clusapi.h)

發行項
02/23/2024

列舉資源類型的可能擁有者節點或資源，並傳回每個呼叫一個節點或資源的名稱。 PCLUSAPI_CLUSTER_RESOURCE_TYPE_ENUM類型會定義此函式的指標。

語法

DWORD ClusterResourceTypeEnum(
  [in]      HRESTYPEENUM hResTypeEnum,
  [in]      DWORD        dwIndex,
  [out]     LPDWORD      lpdwType,
  [out]     LPWSTR       lpszName,
  [in, out] LPDWORD      lpcchName
);

參數

[in] hResTypeEnum

從 ClusterResourceTypeOpenEnum 傳回的資源類型列舉句柄。

[in] dwIndex

要傳回之資源或節點物件的索引。第一次呼叫 ClusterResourceTypeEnum 時，此參數應該是零，然後針對後續呼叫遞增。

[out] lpdwType

ClusterResourceTypeEnum 傳回的物件類型。下列 CLUSTER_RESOURCE_TYPE_ENUM 列舉值有效。

CLUSTER_RESOURCE_TYPE_ENUM_NODES (1)

對像是可以是資源類型的可能擁有者的節點。

CLUSTER_RESOURCE_TYPE_ENUM_RESOURCES (2)

對像是資源類型的實例資源。

[out] lpszName

以 Null 結尾的 Unicode 字串指標，其中包含傳回之物件的名稱。

[in, out] lpcchName

以字元計數表示 之 lpszName 緩衝區大小的指標。在輸入時，指定緩衝區可保留的最大字元數，包括終止 NULL。在輸出中，指定結果名稱中的字元數，不包括終止 NULL。

傳回值

函式會傳回下列其中一個值。

傳回碼/值	Description
ERROR_SUCCESS 0	作業成功。
ERROR_NO_MORE_ITEMS 259	不會再傳回任何物件。
ERROR_MORE_DATA 234	lpszName 指向的緩衝區不夠大，無法保存結果。 lpcchName 參數會傳回結果中的字元數，不包括終止 NULL。
系統錯誤碼	作業失敗。

備註

請注意， lpcchName 是指字元計數，而不是位元組計數，而且傳回的大小不包含計數中的終止 NULL 。如需重設大小緩衝區的詳細資訊，請參閱數據大小慣例。

範例

請參閱列舉物件。

規格需求

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