ResUtilGetResourceDependency-Funktion (resapi.h)

Artikel
03/13/2024

Listet die Abhängigkeiten einer angegebenen Ressource auf und gibt ein Handle an eine Abhängigkeit eines angegebenen Typs zurück. Der PRESUTIL_GET_RESOURCE_DEPENDENCY Typ definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in] hSelf

Handle für die abhängige Ressource. Diese Ressource hängt von einer oder mehreren Ressourcen ab.

[in] lpszResourceType

Unicode-Zeichenfolge mit Null-Termin, die den Ressourcentyp der zurückzugebenden Abhängigkeit angibt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Handle an eine der Ressourcen zurück, von denen die durch hSelf angegebene Ressource abhängt. Der Aufrufer ist dafür verantwortlich, das Handle durch Aufrufen von CloseClusterResource zu schließen.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zu erhalten.

Hinweise

Die Funktionen ResUtilGetResourceDependency, ResUtilGetResourceDependencyByName und ResUtilGetResourceNameDependency sind sehr ähnlich, da sie alle Zugriff auf Abhängigkeiten eines bestimmten Ressourcentyps ermöglichen. In der folgenden Tabelle sind die Unterschiede zwischen den Funktionen zusammengefasst.

Funktion	Angeben der abhängigen Ressource	Erfordert Clusterhandle
ResUtilGetResourceDependency	Ressourcenhandle	No
ResUtilGetResourceDependencyByName	Ressourcenhandle	Yes
ResUtilGetResourceNameDependency	Ressourcenname	No

Rufen Sie ResUtilGetResourceDependency nicht über eine Ressourcen-DLL-Einstiegspunktfunktion auf. ResUtilGetResourceDependency kann sicher aus einem Workerthread aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Beispiele

Wie im folgenden Beispiel veranschaulicht, können Sie resUtilGetResourceDependency verwenden, wenn Sie wissen, dass Ressource A von einer Ressource für physische Datenträger abhängt, um ein Handle für die Abhängigkeit abzurufen.

// 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.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.lib
DLL	ResUtils.dll