PONLINE_V2_ROUTINE回呼函式 (resapi.h)

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

保留的。

傳回值

傳回碼/值	Description
ERROR_SUCCESS 0	作業成功，且資源已上線。
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	資源是與其他一些系統進行仲裁，而另一個系統則贏得仲裁。只有支援仲裁的資源才會傳回此值。
ERROR_IO_PENDING 997 (0x3E5)	要求擱置中，且線程已啟動以處理在線要求。

如果作業因其他原因而未成功，則會傳回系統錯誤碼。

規格需求

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

另請參閱

資源 DLL Entry-Point 函式

共用方式為