POFFLINE_V2_ROUTINE回调函数 (resapi.h)

项目
03/05/2024

清理处理完成后，将资源标记为不可用。 POFFLINE_V2_ROUTINE类型定义指向此函数的指针。

语法

POFFLINE_V2_ROUTINE PofflineV2Routine;

DWORD PofflineV2Routine(
  [in]           RESID Resource,
  [in, optional] LPCWSTR DestinationNodeName,
  [in]           DWORD OfflineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

参数

[in] Resource

要脱机的资源的资源标识符。

[in, optional] DestinationNodeName

操作完成时要包含资源的节点的名称。

[in] OfflineFlags

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

CLUS_RESDLL_OFFLINE_IGNORE_RESOURCE_STATUS (0x00000001)

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

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000002)

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

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED (0x00000004)

如果操作因资源 DLL 延迟，则将其排队，然后重试该操作，直到该操作完成或被客户端取消。

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR (0x00000008)

指示资源遇到错误，并且正在返回到源节点。

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE (0x00000010)

指示存在嵌入故障。

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000020)

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

Windows Server 2012：在Windows Server 2012 R2 之前不支持此值。

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000040)

不要更新资源的持久状态。

Windows Server 2012 R2 和Windows Server 2012：在Windows Server 2016之前不支持此值。

[in, optional] InBuffer

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

[in] InBufferSize

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

[in] Reserved

保留。

返回值

返回代码/值	说明
ERROR_SUCCESS 0	请求已成功完成，并且资源处于脱机状态。
ERROR_IO_PENDING 997 (0x3E5)	请求仍处于挂起状态，并且已激活线程来处理脱机请求。

如果操作由于其他原因未成功，此函数将返回系统错误代码之一。

要求

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

另请参阅

资源 DLL 入口点函数

通过