Função GetClusterNodeId (clusapi.h)

Retorna o identificador exclusivo de um nó de cluster. O tipo PCLUSAPI_GET_CLUSTER_NODE_ID define um ponteiro para essa função.

Sintaxe

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

Parâmetros

[in, optional] hNode

Manipule para o nó com o identificador a ser retornado ou NULL. Se hNode estiver definido como NULL, o identificador de nó para o nó no qual o aplicativo está em execução será retornado no conteúdo de lpszNodeId.

[out] lpszNodeId

Esse parâmetro aponta para um buffer que recebe a ID exclusiva do hNode, incluindo o caractere NULL de terminação.

[in, out] lpcchName

Na entrada, ponteiro para a contagem de caracteres no buffer apontado pelo parâmetro lpszNodeId , incluindo o terminador NULL . Na saída, ponteiro para a contagem de caracteres armazenados no buffer, excluindo o terminador NULL .

Retornar valor

Essa função retorna um código de erro do sistema. O valores possíveis são os seguintes:

Valor/código retornado	Descrição
ERROR_SUCCESS 0	A operação foi concluída com sucesso.
ERROR_MORE_DATA 234 (0xEA)	Mais dados disponíveis. Esse valor será retornado se o buffer apontado por lpszNodeId não for longo o suficiente para manter o número necessário de caracteres. GetClusterNodeId define o conteúdo de lpcchName para o comprimento necessário.

Comentários

O tipo PCLUSAPI_GET_CLUSTER_NODE_ID define um ponteiro para essa função.

Se hNode estiver definido como NULL e o chamador estiver em execução em um nó de cluster ativo, a função GetClusterNodeId retornará o identificador do nó no qual o aplicativo está em execução. Definir hNode como NULL é uma maneira conveniente para que as DLLs de recurso determinem o identificador de nó do nó em que estão em execução. A macro GetCurrentClusterNodeId pode ser usada em vez de passar NULL para o parâmetro hNode .

Um identificador de nó de cluster é um identificador exclusivo que não é alterado mesmo se o nome do nó for alterado.

Observe que lpcchName refere-se a uma contagem de caracteres e não a uma contagem de bytes e que o tamanho retornado não inclui o NULL de terminação na contagem. Para obter mais informações sobre o dimensionamento de buffers, consulte Convenções de tamanho de dados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de Destino	Windows
Cabeçalho	clusapi.h
Biblioteca	ClusAPI.lib
DLL	ClusAPI.dll

Confira também

GetCurrentClusterNodeId

Funções de gerenciamento de nó

OpenClusterNode