RESOURCE_STATUS structure (resapi.h)
Contient des informations sur une ressource mise en ligne ou mise hors connexion. Cette structure est utilisée comme paramètre pour la fonction de rappel SetResourceStatus.
Syntaxe
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
Membres
ResourceState
Valeur décrivant l’état d’une ressource énumérée par l’énumération CLUSTER_RESOURCE_STATE . Les valeurs possibles pour ce membre sont les suivantes :
ClusterResourceStateUnknown (-1)
Une erreur s’est produite lors de la tentative de récupération de l’état, généralement parce que le serveur n’est plus disponible. Pour plus d’informations, l’appelant doit appeler la fonction GetLastError.
ClusterResourceOnline (2)
La ressource est en ligne et disponible.
ClusterResourceOffline (3)
La ressource est hors connexion et non disponible.
ClusterResourceFailed (4)
La ressource a échoué.
ClusterResourceOnlinePending (129)
La ressource est en cours de mise en ligne. Le membre CheckPoint doit être supérieur à la valeur précédente de ce membre.
ClusterResourceOfflinePending (130)
La ressource est en cours de mise hors connexion.
CheckPoint
Valeur définie par la DLL de ressource pour marquer un rapport status comme nouveau.
WaitHint
Ce membre n’est pas utilisé pour l’instant.
EventHandle
Gérez un événement qui indique quand la ressource a échoué.
Remarques
Les DLL de ressources définissent généralement le membre ResourceState sur ClusterResourceOnline ou ClusterResourceOffline. Toutefois, si ResourceState est défini sur ClusterResourceOnlinePending ou ClusterResourceOfflinePending, le membre CheckPoint doit être supérieur à la valeur précédente signalée pour CheckPoint.
Les DLL de ressources définissent initialement CheckPoint sur zéro, puis l’incrémentent de 1 pour chaque appel à SetResourceStatus. Les moniteurs de ressources détectent les nouveaux rapports status en comparant la valeur actuelle de CheckPoint à la valeur précédente. Si la valeur a changé, le Moniteur de ressources lit les nouvelles informations status.
Avant de retourner l’état ClusterResourceUnknown dans le membre ResourceState , une DLL de ressource doit appeler la fonction SetLastError.
Les DLL de ressources définissent le membre EventHandle sur un handle qui est signalé en cas d’échec d’une ressource.
Pour plus d’informations, consultez Implémentation de DLL de ressources.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Entreprise, Windows Server 2008 Datacenter |
| En-tête | resapi.h |