POFFLINE_V2_ROUTINE回呼函式 (resapi.h)

發行項
03/01/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

保留的。

傳回值

傳回碼/值	Description
ERROR_SUCCESS 0	要求已順利完成，且資源已離線。
ERROR_IO_PENDING 997 (0x3E5)	要求仍在擱置中，且線程已啟動以處理離線要求。

如果作業因其他原因而失敗，此函式會傳回其中一個系統錯誤碼。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2012
目標平台	Windows
標頭	resapi.h

另請參閱

資源 DLL 進入點函式

共用方式為