ResUtilGetResourceDependencyByNameEx-Funktion (resapi.h)

Artikel
08/25/2023

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 PRESUTIL_GET_RESOURCE_DEPENDENCY_BY_NAME_EX Typ definiert einen Zeiger auf diese Funktion.

Syntax

HRESOURCE ResUtilGetResourceDependencyByNameEx(
  [in] HCLUSTER hCluster,
  [in] HANDLE   hSelf,
  [in] LPCWSTR  lpszResourceType,
  [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 hängt von einer oder mehreren Ressourcen ab.

[in] lpszResourceType

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

[in] bRecurse

Bestimmt den Bereich der Suche. Bei 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 von GENERIC_ALL entspricht dem Aufrufen von ResUtilGetResourceDependencyByName.

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.

Rückgabecode	Beschreibung
HRESOURCE
NULL	Der Vorgang war nicht erfolgreich. Weitere Informationen erhalten Sie, wenn Sie die Funktion GetLastError aufrufen.

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

Freigeben über