структура RESOURCE_STATUS (resapi.h)
Содержит сведения о ресурсе , который переключается в режим "в сети" или отключается. Эта структура используется в качестве параметра функции обратного вызова SetResourceStatus.
Синтаксис
typedef struct RESOURCE_STATUS {
CLUSTER_RESOURCE_STATE ResourceState;
DWORD CheckPoint;
DWORD WaitHint;
HANDLE EventHandle;
} RESOURCE_STATUS, *PRESOURCE_STATUS;
Члены
ResourceState
Значение , описывающее состояние ресурса, перечисляемого перечислением CLUSTER_RESOURCE_STATE . Возможные значения для этого элемента:
ClusterResourceStateUnknown (-1)
При попытке получить состояние произошла ошибка, как правило, из-за того, что сервер больше недоступен. Для получения дополнительных сведений вызывающий объект должен вызвать функцию GetLastError.
ClusterResourceOnline (2)
Ресурс находится в сети и доступен.
ClusterResourceOffline (3)
Ресурс находится в автономном режиме и недоступен.
ClusterResourceFailed (4)
Ресурс завершился сбоем.
ClusterResourceOnlinePending (129)
Ресурс находится в процессе размещения в сети. Элемент CheckPoint должен быть больше предыдущего значения этого элемента.
ClusterResourceOfflinePending (130)
Ресурс находится в процессе отключения.
CheckPoint
Значение, заданное библиотекой DLL ресурса для пометки отчета о состоянии как нового.
WaitHint
В настоящее время этот элемент не используется.
EventHandle
Обработка события, указывающего на сбой ресурса.
Комментарии
Библиотеки DLL ресурсов обычно устанавливают для элемента ResourceState значение ClusterResourceOnline или ClusterResourceOffline. Однако если параметр ResourceState имеет значение ClusterResourceOnlinePending или ClusterResourceOfflinePending, элемент CheckPoint должен быть больше предыдущего значения, указанного для CheckPoint.
Библиотеки DLL ресурсов изначально устанавливают для CheckPoint нулевое значение, а затем увеличивают его на 1 для каждого вызова SetResourceStatus. Мониторы ресурсов обнаруживают новые отчеты о состоянии путем сравнения текущего значения CheckPoint с предыдущим значением. Если значение изменилось, монитор ресурсов считывает сведения о новом состоянии.
Прежде чем возвращать состояние ClusterResourceUnknown в элементе ResourceState , библиотека DLL ресурса должна вызвать функцию SetLastError.
Библиотеки DLL ресурсов задают элементу EventHandle дескриптор, который получает сигнал при сбое ресурса.
Дополнительные сведения см. в разделе Реализация библиотек DLL ресурсов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
| Верхняя часть | resapi.h |