PONLINE_V2_ROUTINE回调函数 (resapi.h)

项目
03/05/2024

将资源标记为可用。 PONLINE_V2_ROUTINE类型定义指向此函数的指针。

语法

PONLINE_V2_ROUTINE PonlineV2Routine;

DWORD PonlineV2Routine(
  [in]           RESID Resource,
  [out]          LPHANDLE EventHandle,
  [in]           DWORD OnlineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

参数

[in] Resource

要提供的资源的资源标识符。

[out] EventHandle

输入时， EventHandle 为 NULL。在输出时， EventHandle 包含非信号同步对象的句柄。资源 DLL 可以随时向此句柄发出信号，以向资源监视器报告资源故障。 EventHandle 还可以在输出时设置为 NULL ，这表示资源不支持异步事件通知。

[in] OnlineFlags

指定此操作设置的标志的位掩码。此参数可以设置为以下一个或多个值：

CLUS_RESDLL_ONLINE_RECOVER_MONITOR_STATE (0x00000001)

如果资源正在从错误中恢复，请监视资源的状态。

CLUS_RESDLL_ONLINE_IGNORE_RESOURCE_STATUS (0x00000002)

即使资源指示应锁定该资源，也执行该操作。

CLUS_RESDLL_ONLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000004)

如果资源遇到错误，请将其返回到源节点。

CLUS_RESDLL_ONLINE_RESTORE_ONLINE_STATE (0x00000008)

将资源的状态设置为“联机”。

CLUS_RESDLL_ONLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000010)

即使存在网络错误，也执行该操作。

[in, optional] InBuffer

指向包含操作数据的缓冲区的指针;否则，如果操作不需要数据，则为 NULL 。

[in] InBufferSize

InBuffer 参数的大小（以字节为单位）。

[in] Reserved

保留。

返回值

返回代码/值	说明
ERROR_SUCCESS 0	操作成功，并且资源处于联机状态。
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	该资源与其他一些系统一起仲裁，其他一个系统赢得了仲裁。只有支持仲裁的资源才会返回此值。
ERROR_IO_PENDING 997 (0x3E5)	请求处于挂起状态，并且线程已激活以处理联机请求。

如果操作由于其他原因未成功，则返回系统错误代码。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2012 R2
目标平台	Windows
标头	resapi.h

另请参阅

资源 DLL Entry-Point 函数

通过