GetClusterInformation-Funktion (clusapi.h)

Artikel
02/26/2024

Ruft den Namen und die Version eines Clusters ab. Der PCLUSAPI_GET_CLUSTER_INFORMATION-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

Parameter

[in] hCluster

Handle mit einem Cluster.

[out] lpszClusterName

Zeiger auf eine unicode-Zeichenfolge mit Null-Endung, die den Namen des von hCluster identifizierten Clusters enthält.

[in, out] lpcchClusterName

Zeiger auf die Größe des Puffers lpszClusterName als Anzahl von Zeichen. Geben Sie bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich des beendenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der beendende NULL-Wert ausgeschlossen wird.

[out, optional] lpClusterInfo

Entweder NULL oder ein Zeiger auf eine CLUSTERVERSIONINFO-Struktur , die die Version des Clusterdiensts beschreibt. Wenn lpClusterInfo nicht NULL ist, sollte das dwVersionInfoSize-Element dieser Struktur wie folgt festgelegt werden: lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS (0) zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden ist einer der möglichen Werte aufgeführt.

Rückgabecode	Beschreibung
ERROR_MORE_DATA	Der Puffer, auf den lpszClusterName verweist, ist nicht groß genug, um das Ergebnis zu halten. Der Parameter lpcchClusterName gibt die Anzahl der Zeichen im Ergebnis zurück, wobei das beendende NULL ausgeschlossen wird.

Hinweise

Beachten Sie, dass lpcchClusterName auf eine Anzahl von Zeichen und nicht auf die Anzahl von Bytes verweist, und dass die zurückgegebene Größe nicht den beendenden NULL in der Anzahl enthält. Weitere Informationen zur Größenanpassung von Puffern finden Sie unter Datengrößenkonventionen.

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

Weitere Informationen

CLUSTERVERSIONINFO

Freigeben über