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 ，表示資源不支援異步事件通知。
傳回值
| 傳回碼/值 | Description |
|---|---|
|
作業成功，且資源現在已 上線。 |
|
資源是與其他一些系統進行仲裁，而另一個系統則贏得仲裁。 只有 支援仲裁的資源 才會傳回此值。 |
|
要求擱置中，且線程已啟動以處理在線要求。 |
如果作業因其他原因而失敗， Online 應該會傳回其中一個 系統錯誤碼。
備註
如果 Online 進入點函式傳回 ERROR_IO_PENDING以外的錯誤碼，資源監視器會記錄事件並呼叫 Terminate。
傳回有效的 EventHandle 會產生下列優點：
- 資源監視器不會執行 LooksAlive 輪詢。 避免此額外負荷通常很有用，特別是當您的 DLL 支援多個資源實例時。
- 您可以發出句柄的訊號，隨時報告資源失敗。 資源監視器會立即呼叫 IsAlive ，以確認資源失敗。
範例
請參閱 資源 DLL 範例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | resapi.h |