Funzione GetClusterNodeId (clusapi.h)

Articolo
03/08/2023

Restituisce l'identificatore univoco di un nodo del cluster. Il tipo PCLUSAPI_GET_CLUSTER_NODE_ID definisce un puntatore a questa funzione.

Sintassi

DWORD GetClusterNodeId(
  [in, optional] HNODE   hNode,
  [out]          LPWSTR  lpszNodeId,
  [in, out]      LPDWORD lpcchName
);

Parametri

[in, optional] hNode

Gestire il nodo con l'identificatore da restituire o NULL. Se hNode è impostato su NULL, l'identificatore del nodo per il nodo in cui è in esecuzione l'applicazione viene restituito nel contenuto di lpszNodeId.

[out] lpszNodeId

Questo parametro punta a un buffer che riceve l'ID univoco di hNode, incluso il carattere NULL terminante.

[in, out] lpcchName

In input, puntatore al conteggio dei caratteri nel buffer a cui punta il parametro lpszNodeId , incluso il terminatore NULL . Nell'output, puntatore al numero di caratteri archiviati nel buffer escluso il terminatore NULL .

Valore restituito

Questa funzione restituisce un codice di errore di sistema. Di seguito sono indicati i valori possibili:

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Operazione riuscita.
ERROR_MORE_DATA 234 (0xEA)	sono disponibili più dati. Questo valore viene restituito se il buffer puntato da lpszNodeId non è abbastanza lungo per contenere il numero di caratteri richiesto. GetClusterNodeId imposta il contenuto di lpcchName sulla lunghezza necessaria.

Commenti

Il tipo PCLUSAPI_GET_CLUSTER_NODE_ID definisce un puntatore a questa funzione.

Se hNode è impostato su NULL e il chiamante è in esecuzione in un nodo cluster attivo, la funzione GetClusterNodeId restituisce l'identificatore del nodo in cui è in esecuzione l'applicazione. L'impostazione di hNode su NULL è un modo pratico per le DLL delle risorse per determinare l'identificatore del nodo in esecuzione. La macro GetCurrentClusterNodeId può essere usata anziché passare NULL per il parametro hNode .

Un identificatore del nodo del cluster è un identificatore univoco che non cambia anche se il nome del nodo viene modificato.

Si noti che lpcchName fa riferimento a un conteggio di caratteri e non a un conteggio di byte e che la dimensione restituita non include il valore NULL terminante 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

GetCurrentClusterNodeId

Funzioni di gestione dei nodi

OpenClusterNode

Condividi tramite