PONLINE_ROUTINE回调函数 (resapi.h)
将 资源 标记为可供使用。 PONLINE_ROUTINE类型定义指向此函数的指针。
语法
PONLINE_ROUTINE PonlineRoutine;
DWORD PonlineRoutine(
[in] RESID Resource,
[in, out] LPHANDLE EventHandle
)
{...}
参数
[in] Resource
要可用的资源的资源标识符。
[in, out] EventHandle
输入时， EventHandle 为 NULL。 在输出 中，EventHandle 包含非签名 同步对象的句柄。 资源 DLL 可以随时发出此句柄的信号，以向资源监视器报告资源故障。 EventHandle 还可以在输出时设置为 NULL ，表示资源不支持异步事件通知。
返回值
| 返回代码/值 | 说明 |
|---|---|
|
操作成功，资源现在 处于联机状态。 |
|
资源与其他一些系统一起仲裁，其他一个系统赢得了仲裁。 只有 支持仲裁的资源 才会返回此值。 |
|
请求处于挂起状态，并且已激活线程来处理联机请求。 |
如果操作因其他原因未成功， Online 应返回 系统错误代码之一。
注解
如果 Online 入口点函数返回 除 ERROR_IO_PENDING 以外的错误代码，则资源监视器将记录事件并调用 Terminate。
返回有效的 EventHandle 将产生以下优势：
- 资源监视器不会执行 LooksAlive 轮询。 避免此开销通常很有用，尤其是在 DLL 支持多个资源实例时。
- 可以随时通过向句柄发出信号来报告资源故障。 资源监视器将立即调用 IsAlive 来验证资源是否已失败。
示例
请参阅 资源 DLL 示例。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
| 目标平台 | Windows |
| 标头 | resapi.h |