IGetClusterDataInfo::GetClusterName-Methode (cluadmex.h)

Artikel
02/26/2024

[Diese Methode steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Die Unterstützung für diese Methode wurde in Windows Server 2008 entfernt.]

Gibt den Namen des Clusters zurück.

Syntax

HRESULT GetClusterName(
  [out]     BSTR lpszName,
  [in, out] LONG *pcchName
);

Parameter

[out] lpszName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Clusters enthält; oder NULL , um anzugeben, dass der Aufrufer nur die Länge des Namens anfordert. Obwohl dieser Parameter als BSTR deklariert ist, wird er als LPWSTR implementiert.

[in, out] pcchName

Zeigen Sie bei der Eingabe auf die Größe des Puffers in Zeichen, auf die der lpszName-Parameter verweist. Zeigen Sie in der Ausgabe auf die Gesamtzahl der Zeichen im Puffer, einschließlich des NULL-Endzeichens.

Rückgabewert

Wenn GetClusterName nicht erfolgreich ist, kann es andere HRESULT-Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
NOERROR 0	Der Vorgang wurde durchgeführt.
E_INVALIDARG 0x80070057	Mindestens ein Parameter ist ungültig.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) 0x800700ea	Der Puffer, auf den lpszName verweist, ist zu klein, um den angeforderten Namen zu speichern. GetClusterName gibt die erforderliche Anzahl von Zeichen im Inhalt von pcchName zurück.

Hinweise

Wenn der lpszName-Parameter auf NULL festgelegt ist und der pcchName-Parameter nicht auf NULL festgelegt ist, gibt die GetClusterName-MethodeNOERROR zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Zielplattform	Windows
Kopfzeile	cluadmex.h

Weitere Informationen

IGetClusterDataInfo

Freigeben über