GetClusterFromResource-Funktion (clusapi.h)
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 |