ResUtilGetResourceNameDependency-Funktion (resapi.h)

Artikel
08/25/2023

Listet die Abhängigkeiten einer angegebenen Ressource im lokalen Cluster auf und gibt ein Handle zu einer Abhängigkeit eines angegebenen Ressourcentyps zurück. Der PRESUTIL_GET_RESOURCE_NAME_DEPENDENCY-Typs definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in] lpszResourceName

Unicode-Zeichenfolge mit Null-Endung, die den Namen der abhängigen Ressource angibt. Diese Ressource ist von mindestens einer Ressource abhängig.

[in] lpszResourceType

Unicode-Zeichenfolge mit Null-Beendigung, 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 lpszResourceName angegebene Ressource abhängt. Der Aufrufer ist für das Schließen des Handle durch Aufrufen von CloseClusterResource verantwortlich.

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

Hinweise

Die Funktionen ResUtilGetResourceNameDependency, ResUtilGetResourceDependency und ResUtilGetResourceDependencyByName 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	Angabe der abhängigen Ressource	Clusterhandle erfordert
ResUtilGetResourceDependency	Ressourcenhandle	Nein
ResUtilGetResourceDependencyByName	Ressourcenhandle	Ja
ResUtilGetResourceNameDependency	Ressourcenname	Nein

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

Beispiele

Wie das folgende Beispiel veranschaulicht, können Sie resUtilGetResourceNameDependency verwenden, wenn Sie wissen, dass Ressource A von einer physischen Datenträgerressource abhängt, um ein Handle für die Abhängigkeit abzurufen.

// String initialization and error checking omitted.

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

// Close handles and free memory.

Anforderungen


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