Funzione GetClusterInformation (clusapi.h)

Articolo
02/26/2024

Recupera il nome e la versione di un cluster . Il tipo PCLUSAPI_GET_CLUSTER_INFORMATION definisce un puntatore a questa funzione.

Sintassi

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

Parametri

[in] hCluster

Gestire in un cluster.

[out] lpszClusterName

Puntatore a una stringa Unicode con terminazione Null contenente il nome del cluster identificato da hCluster.

[in, out] lpcchClusterName

Puntatore alla dimensione del buffer lpszClusterName come numero di caratteri. In input, specificare il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL di terminazione. Nell'output specifica il numero di caratteri nel nome risultante, escluso il valore NULL di terminazione.

[out, optional] lpClusterInfo

Null o un puntatore a una struttura CLUSTERVERSIONINFO che descrive la versione del servizio cluster. Quando lpClusterInfo non è NULL, il membro dwVersionInfoSize di questa struttura deve essere impostato come segue: lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS (0).

Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema. Di seguito è riportato uno dei valori possibili.

Codice restituito	Descrizione
ERROR_MORE_DATA	Il buffer a cui punta lpszClusterName non è sufficientemente grande da contenere il risultato. Il parametro lpcchClusterName restituisce il numero di caratteri nel risultato, escluso il valore NULL di terminazione.

Commenti

Si noti che lpcchClusterName fa riferimento a un conteggio di caratteri e non a un conteggio di byte e che le dimensioni restituite non includono il valore NULL di terminazione nel conteggio. Per altre informazioni sul ridimensionamento dei buffer, vedere Convenzioni delle dimensioni dei dati.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

CLUSTERVERSIONINFO

Condividi tramite