ResUtilGetResourceDependencyByName-Funktion (resapi.h)

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

Syntax

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

Die Parameter

[in] hCluster

Behandeln Sie den Cluster, zu dem die Ressource gehört.

[in] hSelf

Behandeln sie die abhängige Ressource. Diese Ressource hängt von einer oder mehreren Ressourcen ab.

[in] lpszResourceType

UNICODE-Zeichenfolge mit NULL-Beendigung, die den Ressourcentyp der zurückzugebenden Abhängigkeit angibt.

[in] bRecurse

Bestimmt den Bereich der Suche. Wenn WAHR, überprüft die Funktion die gesamte Abhängigkeitsstruktur unter der abhängigen Ressource. Wenn FALSCH, überprüft die Funktion nur die Ressourcen, von denen die abhängige Ressource direkt abhängt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Handle an eine der Ressourcen zurück, von denen die von hSelf 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 GetLastError-Funktion auf, um weitere Informationen zu erhalten.

Rückgabecode	Description
HRESOURCE
NULL	Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zu erhalten.

Bemerkungen

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

Funktion	Angeben der abhängigen Ressource	Erfordert Clusterhandle
ResUtilGetResourceDependency	Ressourcenhandle	Nein
ResUtilGetResourceDependencyByName	Ressourcenhandle	Ja.
ResUtilGetResourceNameDependency	Ressourcenname	Nein

 

Rufen Sie ResUtilGetResourceDependencyByName nicht von einer Ressourcen-DLL-Einstiegspunktfunktion auf. ResUtilGetResourceDependencyByName kann sicher über einen Arbeitsthread aufgerufen werden. Weitere Informationen finden Sie unter Funktionsaufrufe, die in Ressourcen-DLLs vermieden werden sollen.

Examples

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

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

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Nicht unterstützt
Mindestanforderungen für unterstützte Server	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Fenster
Header	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll

Siehe auch

CloseClusterResource

ResUtilFindDependentDiskResourceDriveLetter

ResUtilGetResourceDependency

ResUtilGetResourceDependencyByClass

ResUtilGetResourceDependentIPAddressProps

ResUtilGetResourceNameDependency