RtmReleaseDests 函式 (rtmv2.h)

RtmReleaseDests 函式會釋放目的地控制碼。

語法

DWORD RtmReleaseDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    DestInfos
);

[in] RtmRegHandle

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

[in] NumDests

指定 DestInfos中的目的地數目。

[in] DestInfos

要釋放之RTM_DEST_INFO 結構的陣列指標。目的地是從先前呼叫 RtmGetEnumDests取得。

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

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

值	意義
ERROR_INVALID_HANDLE	控制代碼無效。

請勿使用此函式來釋放從呼叫 RtmGetChangedDests取得RTM_DEST_INFO結構。請改用 RtmReleaseChangedDests 。

RTM_DEST_INFO結構是可變大小的結構。如果目的地包含多個檢視的資訊，每個檢視 RTM_DEST_INFO 的大小就會增加。使用 RTM_SIZE_OF_DEST_INFO 宏來判斷呼叫此函式之前，要配置 多少 DestInfos 緩衝區。