ResUtilGetResourceDependencyByName 函式 (resapi.h)

發行項
03/01/2024

列舉指定叢集中指定資源的相依性，並將句柄傳回指定類型的相依性。 PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_NAME類型會定義此函式的指標。

語法

HRESOURCE ResUtilGetResourceDependencyByName(
  [in] HCLUSTER hCluster,
  [in] HANDLE   hSelf,
  [in] LPCWSTR  lpszResourceType,
  [in] BOOL     bRecurse
);

參數

[in] hCluster

資源所屬叢集的句柄。

[in] hSelf

相依資源的句柄。此資源相依於一或多個資源。

[in] lpszResourceType

NULL 終止的 Unicode 字串，指定要傳回之相依性的資源類型。

[in] bRecurse

決定搜尋的範圍。如果 為 TRUE，函式會檢查相依資源下的整個相依性樹狀結構。如果為 FALSE，函式只會檢查相依資源直接相依的資源。

傳回值

如果作業成功，函式會將句柄傳回 hSelf 所指定資源的其中一個資源。呼叫端負責藉由呼叫 CloseClusterResource 來關閉句柄。

如果作業失敗，函式會傳回 NULL。如需詳細資訊，請呼叫 GetLastError 函式。

傳回碼	Description
HRESOURCE
NULL	作業未成功。如需詳細資訊，請呼叫函式 GetLastError。

備註

ResUtilGetResourceDependencyByName、ResUtilGetResourceDependency 和 ResUtilGetResourceNameDependency 函式非常類似，因為它們都提供特定資源類型的相依性存取權。下列清單摘要說明函式之間的差異。

函式	如何指定相依資源	需要叢集句柄
ResUtilGetResourceDependency	資源句柄	No
ResUtilGetResourceDependencyByName	資源句柄	Yes
ResUtilGetResourceNameDependency	資源名稱	No

請勿從任何資源 DLL 進入點函式呼叫 ResUtilGetResourceDependencyByName 。 ResUtilGetResourceDependencyByName 可以從背景工作線程安全地呼叫。如需詳細資訊，請參閱在資源 DLL 中避免的函數調用。

範例

如下列範例所示，如果您知道資源 A 相依於實體磁碟資源，您可以使用 ResUtilGetResourceDependencyByName 來取得相依性的句柄。

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

//
// Resource A depends on a storage class resource.
// Get a handle to that resource.
//
HRESOURCE hResA = OpenClusterResource( hCluster, lpszResName );

HRESOURCE hResD = ResUtilGetResourceDependencyByName(
                        hCluster,
                        hResA,
                        L"Physical Disk",
                        TRUE );

// Close handles and free memory.

規格需求

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