Função GetNodeClusterState (clusapi.h)

Determina se o serviço cluster está instalado e em execução em um nó. O tipo PCLUSAPI_GET_NODE_CLUSTER_STATE define um ponteiro para essa função.

Sintaxe

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

Parâmetros

[in, optional] lpszNodeName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do nó a ser consultado. Se lpszNodeName for NULL, o nó local será consultado.

[out] pdwClusterState

Ponteiro para um valor que descreve o estado do serviço cluster no nó. Um nó será descrito por um dos seguintes valores de enumeração NODE_CLUSTER_STATE .

ClusterStateNotInstalled (0)

O serviço cluster não está instalado no nó.

ClusterStateNotConfigured (1)

O serviço cluster está instalado no nó, mas ainda não foi configurado.

ClusterStateNotRunning (3)

O serviço cluster está instalado e configurado no nó, mas não está em execução no momento.

ClusterStateRunning (19 (0x13))

O serviço de cluster está instalado, configurado e em execução no nó.

Retornar valor

Se a operação for bem-sucedida, a função retornará ERROR_SUCCESS (0). Se a operação falhar, a função retornará um código de erro do sistema.

Comentários

Nota A função GetNodeClusterState não dá suporte a um nó baseado no Windows de 64 bits se o aplicativo de chamada for baseado no Windows de 32 bits.

Requisitos

Confira também

NODE_CLUSTER_STATE

Funções de gerenciamento de nó