ResUtilGetResourceDependency 函式 (resapi.h)

發行項
03/01/2024

列舉指定資源的相依性，並傳回指定型別相依性的句柄。 PRESUTIL_GET_RESOURCE_DEPENDENCY類型會定義此函式的指標。

語法

HRESOURCE ResUtilGetResourceDependency(
  [in] HANDLE  hSelf,
  [in] LPCWSTR lpszResourceType
);

參數

[in] hSelf

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

[in] lpszResourceType

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

傳回值

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

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

備註

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

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

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

範例

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

// String initialization and error checking omitted.

HCLUSTER hCluster = OpenCluster( lpszClusterName );

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

HRESOURCE hResD = ResUtilGetResourceDependency(
                        hResA,
                        L"Physical Disk" );

// Close handles and free memory.

規格需求

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