struttura RESOURCE_STATUS (resapi.h)
Contiene informazioni su una risorsa che viene portata online o portata offline. Questa struttura viene usata come parametro per la funzione di callback SetResourceStatus.
Sintassi
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
Members
ResourceState
Valore che descrive lo stato di una risorsa enumerata dall'enumerazione CLUSTER_RESOURCE_STATE . I valori possibili per questo membro sono i seguenti:
ClusterResourceStateUnknown (-1)
Si è verificato un errore durante il tentativo di recuperare lo stato, in genere perché il server non è più disponibile. Per altre informazioni, il chiamante deve chiamare la funzione GetLastError.
ClusterResourceOnline (2)
La risorsa è online e disponibile.
ClusterResourceOffline (3)
La risorsa è offline e non disponibile.
ClusterResourceFailed (4)
La risorsa non è riuscita.
ClusterResourceOnlinePending (129)
La risorsa è in fase di messa online. Il membro CheckPoint deve essere maggiore del valore precedente di questo membro.
ClusterResourceOfflinePending (130)
La risorsa sta per essere portata offline.
CheckPoint
Valore impostato dalla DLL della risorsa per contrassegnare un report di stato come nuovo.
WaitHint
Questo membro non viene utilizzato in questo momento.
EventHandle
Handle per un evento che indica quando la risorsa non è riuscita.
Commenti
Le DLL delle risorse impostano in genere il membro ResourceState su ClusterResourceOnline o ClusterResourceOffline. Tuttavia, se ResourceState è impostato su ClusterResourceOnlinePending o ClusterResourceOfflinePending, il membro CheckPoint deve essere maggiore del valore precedente segnalato per CheckPoint.
Le DLL delle risorse impostano inizialmente CheckPoint su zero, quindi lo incrementa di 1 per ogni chiamata a SetResourceStatus. Monitoraggio risorse rileva i nuovi report di stato confrontando il valore corrente di CheckPoint con il valore precedente. Se il valore è stato modificato, Monitoraggio risorse legge le nuove informazioni sullo stato.
Prima di restituire lo stato ClusterResourceUnknown nel membro ResourceState , una DLL della risorsa deve chiamare la funzione SetLastError.
Le DLL delle risorse impostano il membro EventHandle su un handle segnalato quando una risorsa ha esito negativo.
Per altre informazioni, vedere Implementazione di DLL delle risorse.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Intestazione | resapi.h |