rtmReferenceHandles 函式 (rtmv2.h)

RtmReferenceHandles 函式會增加路由管理員用來存取這些物件的一或多個句柄所指向對象的參考計數。當客戶端必須保留句柄，但釋放與句柄相關聯的其餘信息結構時，客戶端應該使用此函式。

語法

DWORD RtmReferenceHandles(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumHandles,
  [in] HANDLE            *RtmHandles
);

[in] RtmRegHandle

從先前呼叫 RtmRegisterEntity 取得的用戶端句柄。

[in] NumHandles

指定 RtmHandles 中的句柄數目。

[in] RtmHandles

要增加參考計數的句柄陣列。

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
ERROR_INVALID_HANDLE	控制代碼無效。

用戶端在快取路由表管理員傳回的句柄時，必須一律呼叫此函式。這會通知路由表管理員，它不應該終結句柄所參考的物件，直到客戶端釋放句柄為止。

當客戶端必須釋放句柄時，客戶端必須根據句柄類型呼叫適當的發行函式。例如，若要釋放路由，請呼叫 RtmReleaseRoutes。