rtmDeregisterEntity 函式 (rtmv2.h)

RtmDeregisterEntity函式會從路由表管理員實例和位址系列取消註冊用戶端。

語法

DWORD RtmDeregisterEntity(
  [in] RTM_ENTITY_HANDLE RtmRegHandle
);

[in] RtmRegHandle

從先前呼叫 RtmRegisterEntity取得的用戶端控制碼。

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

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

值	意義
ERROR_INVALID_HANDLE	控制代碼無效。

呼叫此函式之前，用戶端必須確定所有鎖定、控制碼和資訊結構都會以適當的函式釋放。

當用戶端呼叫 RtmDeregisterEntity時，會釋放先前呼叫 RtmRegisterEntity 所傳回的控制碼。用戶端在釋放此控制碼之後，不得呼叫任何 RTMv2 函式。

如果用戶端在用戶端取消註冊之後呼叫任何存取路由表管理員的函式，用戶端的進程可能會終止。