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 成员设置为 ClusterResourceOnlineClusterResourceOffline。 但是,如果 ResourceState 设置为 ClusterResourceOnlinePendingClusterResourceOfflinePending则 CheckPoint 成员应大于以前为 CheckPoint 报告的值。

资源 DLL 最初将 CheckPoint 设置为零,然后每次调用 SetResourceStatus 时递增 1。 资源监视器 通过将 CheckPoint 的当前值与上一个值进行比较来检测新的状态报告。 如果值已更改,资源监视器将读取新的状态信息。

ResourceState 成员中返回 ClusterResourceUnknown 状态之前,资源 DLL 应调用函数 SetLastError

资源 DLL 将 EventHandle 成员设置为在资源失败时发出信号的句柄。

有关详细信息,请参阅 实现资源 DLL

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 企业版、Windows Server 2008 Datacenter
标头 resapi.h

另请参阅

CLUSTER_RESOURCE_STATE

资源 DLL 结构

SetResourceStatus