Funzione GetNodeClusterState (clusapi.h)

Determina se il servizio cluster è installato ed in esecuzione in un nodo. Il tipo PCLUSAPI_GET_NODE_CLUSTER_STATE definisce un puntatore a questa funzione.

Sintassi

DWORD GetNodeClusterState(
  [in, optional] LPCWSTR lpszNodeName,
  [out]          LPDWORD pdwClusterState
);

Parametri

[in, optional] lpszNodeName

Puntatore a una stringa Unicode con terminazione null contenente il nome del nodo da eseguire per la query. Se lpszNodeName è NULL, viene eseguito una query sul nodo locale.

[out] pdwClusterState

Puntatore a un valore che descrive lo stato del servizio cluster nel nodo. Un nodo verrà descritto da uno dei seguenti valori di enumerazione NODE_CLUSTER_STATE .

ClusterStateNotInstalled (0)

Il servizio cluster non è installato nel nodo.

ClusterStateNotConfigured (1)

Il servizio cluster è installato nel nodo ma non è ancora stato configurato.

ClusterStateNotRunning (3)

Il servizio cluster è installato e configurato nel nodo, ma non è attualmente in esecuzione.

ClusterStateRunning (19 (0x13))

Il servizio cluster è installato, configurato ed in esecuzione nel nodo.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS (0). Se l'operazione ha esito negativo, la funzione restituisce un codice di errore di sistema.

Commenti

Nota La funzione GetNodeClusterState non supporta un nodo basato su Windows a 64 bit se l'applicazione chiamante è basata su Windows a 32 bit.

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

NODE_CLUSTER_STATE

Funzioni di gestione dei nodi