estrutura RESOURCE_STATUS (resapi.h)
Contém informações sobre um recurso que está sendo colocado online ou colocado offline. Essa estrutura é usada como um parâmetro para a função de retorno de chamada SetResourceStatus.
Sintaxe
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
Membros
ResourceState
Um valor que descreve o estado de um recurso enumerado pela enumeração CLUSTER_RESOURCE_STATE . Os valores possíveis para esse membro são os seguintes:
ClusterResourceStateUnknown (-1)
Ocorreu um erro ao tentar recuperar o estado, normalmente porque o servidor não está mais disponível. Para obter mais informações, o chamador deve chamar a função GetLastError.
ClusterResourceOnline (2)
O recurso está online e disponível.
ClusterResourceOffline (3)
O recurso está offline e indisponível.
ClusterResourceFailed (4)
O recurso falhou.
ClusterResourceOnlinePending (129)
O recurso está no processo de ser colocado online. O membro checkpoint deve ser maior que o valor anterior deste membro.
ClusterResourceOfflinePending (130)
O recurso está no processo de ser colocado offline.
CheckPoint
Um valor definido pela DLL do recurso para sinalizar um relatório status como novo.
WaitHint
Este membro não está sendo usado no momento.
EventHandle
Manipule para um evento que indica quando o recurso falhou.
Comentários
As DLLs de recurso normalmente definem o membro ResourceState como ClusterResourceOnline ou ClusterResourceOffline. No entanto, se ResourceState estiver definido como ClusterResourceOnlinePending ou ClusterResourceOfflinePending, o membro checkpoint deverá ser maior do que o valor anterior relatado para CheckPoint.
As DLLs de recurso inicialmente definem CheckPoint como zero e incrementam-no em 1 para cada chamada para SetResourceStatus. Os Monitores de Recursos detectam novos relatórios status comparando o valor atual do CheckPoint com o valor anterior. Se o valor tiver sido alterado, o Monitor de Recursos lerá as novas informações de status.
Antes de retornar o estado ClusterResourceUnknown no membro ResourceState , uma DLL de recurso deve chamar a função SetLastError.
As DLLs de recurso definem o membro EventHandle como um identificador que é sinalizado quando um recurso falha.
Para obter mais informações, consulte Implementando DLLs de recurso.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Cabeçalho | resapi.h |