GetClusterQuorumResource-Funktion (clusapi.h)

Artikel
02/28/2024

Gibt den Namen der Quorumressource eines Clusters zurück. Der PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

Parameter

[in] hCluster

Behandeln sie einen vorhandenen Cluster.

[out] lpszResourceName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der Quorumressource des Clusters enthält. Der Name wird aus der allgemeinen Eigenschaft Name der Quorumressource gelesen. Übergeben Sie null für diesen Parameter nicht.

[in, out] lpcchResourceName

Zeiger auf die Größe des Puffers lpszResourceName 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] lpszDeviceName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Pfad zum Speicherort der quorumprotokolldateien enthält, die vom Clusterdienst verwaltet werden. Übergeben Sie null für diesen Parameter nicht.

[in, out] lpcchDeviceName

Zeiger auf die Größe des Puffers lpszDeviceName 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] lpdwMaxQuorumLogSize

Zeiger auf die maximale Größe (in Bytes) des Protokolls, das von der Quorumressource verwaltet wird. Übergeben Sie null für diesen Parameter nicht.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS 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 lpszResourceName oder lpszDeviceName ist nicht groß genug, um das Ergebnis zu halten. Die Parameter lpcchResourceName und lpcchDeviceName geben die Anzahl der Zeichen im Ergebnis zurück, wobei das beendende NULL ausgeschlossen wird.

Hinweise

Beachten Sie, dass lpcchName 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

Name

SetClusterQuorumResource

Freigeben über