Freigeben über


ResUtilGetResourceDependencyByClassEx-Funktion (resapi.h)

Listet die Abhängigkeiten einer angegebenen Ressource in einem angegebenen Cluster auf und gibt ein Handle an eine Abhängigkeit zurück, die einer angegebenen Ressourcenklasse entspricht. Der PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_CLASS_EX Typ definiert einen Zeiger auf diese Funktion.

Syntax

HRESOURCE ResUtilGetResourceDependencyByClassEx(
  [in] HCLUSTER                  hCluster,
  [in] HANDLE                    hSelf,
  [in] PCLUS_RESOURCE_CLASS_INFO prci,
  [in] BOOL                      bRecurse,
  [in] DWORD                     dwDesiredAccess
);

Parameter

[in] hCluster

Ein Handle für den Cluster, zu dem die Ressource gehört.

[in] hSelf

Ein Handle für die abhängige Ressource. Diese Ressource ist von mindestens einer Ressource abhängig.

[in] prci

Ein Zeiger auf eine PCLUS_RESOURCE_CLASS_INFO Struktur, die die Ressourcenklasse der zurückzugebenden Abhängigkeit beschreibt.

[in] bRecurse

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

[in] dwDesiredAccess

Die angeforderten Zugriffsberechtigungen. Dies kann eine kombination aus GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) oder MAXIMUM_ALLOWED (0x02000000) sein. Wenn dieser Wert null (0) ist, wird möglicherweise ein nicht definierter Fehler zurückgegeben. Die Verwendung GENERIC_ALL ist identisch mit dem Aufrufen von ResUtilGetResourceDependencyByClass.

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.

Anforderungen

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

Weitere Informationen

Ressourcenhilfsprogrammfunktionen