Função GetClusterResourceState (clusapi.h)

Retorna o estado atual de um recurso. O tipo PCLUSAPI_GET_CLUSTER_RESOURCE_STATE define um ponteiro para essa função.

Sintaxe

CLUSTER_RESOURCE_STATE GetClusterResourceState(
  [in]                HRESOURCE hResource,
  [out, optional]     LPWSTR    lpszNodeName,
  [in, out, optional] LPDWORD   lpcchNodeName,
  [out, optional]     LPWSTR    lpszGroupName,
  [in, out, optional] LPDWORD   lpcchGroupName
);

Parâmetros

[in] hResource

Manipule a especificação do recurso para o qual as informações de estado devem ser retornadas.

[out, optional] lpszNodeName

Ponteiro para um buffer que recebe o nome do nó de proprietário atual do recurso especificado como uma cadeia de caracteres Unicode terminada em NULL. Passe NULL se o nome do nó não for necessário.

[in, out, optional] lpcchNodeName

Ponteiro para o tamanho do buffer lpszNodeName como uma contagem de caracteres. Esse ponteiro não pode ser NULL , a menos que lpszNodeName também seja NULL. Na entrada, especifica o número máximo de caracteres que o buffer pode conter, incluindo o NULL de terminação. Na saída, especifica o número de caracteres no nome resultante, excluindo o NULL de terminação.

[out, optional] lpszGroupName

Ponteiro para um buffer que recebe o nome do grupo que contém o recurso especificado. O nome é retornado como uma cadeia de caracteres Unicode terminada em NULL. Passe NULL se o nome do grupo não for necessário.

[in, out, optional] lpcchGroupName

Ponteiro para o tamanho do buffer lpszGroupName como uma contagem de caracteres. Esse ponteiro não pode ser NULL , a menos que lpszNodeName também seja NULL. Na entrada, especifica o número máximo de caracteres que o buffer pode conter, incluindo o NULL de terminação. Na saída, especifica o número de caracteres no nome resultante, excluindo o NULL de terminação.

Valor retornado

GetClusterResourceState retorna o estado atual do recurso enumerado da enumeração CLUSTER_RESOURCE_STATE , que pode ser representada por um dos valores a seguir.

Comentários

Não chame GetClusterResourceState de nenhuma função de ponto de entrada DLL de recurso. GetClusterResourceState pode ser chamado com segurança de um thread de trabalho. Para obter mais informações, consulte Chamadas de função a serem evitadas em DLLs de recurso.

Exemplos

Consulte Obtendo estados de objeto para obter um exemplo.

Requisitos

Confira também

CLUSTER_RESOURCE_STATE

Offline

OfflineClusterResource

Online

OnlineClusterResource

OpenClusterResource