GetClusterFromResource-Funktion (clusapi.h)

Artikel
03/04/2024

Gibt ein Handle an den Cluster zurück, der einer Ressource zugeordnet ist. Der PCLUSAPI_GET_CLUSTER_FROM_RESOURCE Typ definiert einen Zeiger auf diese Funktion.

Syntax

HCLUSTER GetClusterFromResource(
  [in] HRESOURCE hResource
);

Parameter

[in] hResource

Handle für die Ressource.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Handle an den Cluster zurück, der besitzer der Ressource ist.

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

Hinweise

Damit hResource ein gültiges Handle ist, muss unbedingt ein offenes Clusterhandle vorhanden sein (siehe OpenClusterResource). GetClusterFromResource gibt eine weitere instance des Handles zurück, aus dem hResource abgerufen wurde.

Achten Sie darauf , CloseCluster für das von GetClusterFromResource zurückgegebene Handle aufzurufen, bevor das Handle den Gültigkeitsbereich überschreitet. Durch das Schließen dieses Handles wird hResource oder das Clusterhandle, aus dem hResource abgerufen wurde, nicht ungültig.

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	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll