ResUtilGetResourceNameDependency 函式 (resapi.h)

發行項
08/25/2023

列舉本機叢集中指定資源的相依性，並傳回指定資源類型的相依性控制碼。 PRESUTIL_GET_RESOURCE_NAME_DEPENDENCY類型會定義此函式的指標。

語法

HRESOURCE ResUtilGetResourceNameDependency(
  [in] LPCWSTR lpszResourceName,
  [in] LPCWSTR lpszResourceType
);

參數

[in] lpszResourceName

以 Null 結尾的 Unicode 字串，指定相依資源的名稱。此資源相依于一或多個資源。

[in] lpszResourceType

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

傳回值

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

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

備註

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

函式	如何指定相依資源	需要叢集控制碼
ResUtilGetResourceDependency	資源控制碼	否
ResUtilGetResourceDependencyByName	資源控制碼	是
ResUtilGetResourceNameDependency	資源名稱	否

請勿從任何資源 DLL 進入點函 式呼叫 ResUtilGetResourceNameDependency 。 ResUtilGetResourceNameDependency 可以從背景工作執行緒安全地呼叫。如需詳細資訊，請參閱在資源 DLL 中避免的函式呼叫。

範例

如下列範例所示，如果您知道資源 A 相依于實體磁片資源，您可以使用 ResUtilGetResourceNameDependency 來取得相依性的控制碼。

// String initialization and error checking omitted.

HRESOURCE hResD = ResUtilGetResourceNameDependency(
                        L"Resource_A_Name",
                        L"Physical Disk" );

// Close handles and free memory.

需求


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