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 範例。

規格需求

另請參閱

NetShareAdd

資源 DLL Entry-Point 函式