rtmGetExactMatchDestination 函式 (rtmv2.h)
RtmGetExactMatchDestination函式會搜尋路由表,尋找完全符合指定網路位址和子網路遮罩的目的地。 如果找到完全相符專案,則會傳回該目的地的資訊。
語法
DWORD RtmGetExactMatchDestination(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] PRTM_NET_ADDRESS DestAddress,
[in] ULONG ProtocolId,
[in] RTM_VIEW_SET TargetViews,
[out] PRTM_DEST_INFO DestInfo
);
參數
[in] RtmRegHandle
從先前呼叫 RtmRegisterEntity取得的用戶端控制碼。
[in] DestAddress
目的地網路位址的指標。
[in] ProtocolId
指定通訊協定識別碼。 ProtocolID不是搜尋準則的一部分。 路由表管理員會使用此識別碼來判斷要傳回的目的地和路由資訊。 例如,如果用戶端指定 RIP 通訊協定識別碼,即使非 RIP 路由是目的地的最佳路由,也會傳回最佳的 RIP 路由。
指定RTM_BEST_PROTOCOL傳回路由,不論通訊協定擁有哪一個通訊協定。 指定RTM_THIS_PROTOCOL傳回呼叫通訊協定的最佳路由。
[in] TargetViews
指定要從中傳回信息的檢視。 如果用戶端指定RTM_VIEW_MASK_ANY,則會從所有檢視傳回目的地資訊;不過,不會傳回任何檢視特定資訊。
[out] DestInfo
在輸入時, DestInfo 是 RTM_DEST_INFO 結構的指標。
在輸出上, DestInfo 會填入要求的目的地資訊。
傳回值
如果函式成功,傳回值會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
找不到指定的目的地。 |
備註
DestInfo結構是可變大小的結構。 如果用戶端使用 TargetViews指定多個檢視,則每個檢視的大小 會增加 DestInfo 。 使用 RTM_SIZE_OF_DEST_INFO 宏來決定呼叫此函式之前,要配置 多少 DestInfo 結構。 使用針對 TargetViews 指定的值做為參數來 RTM_SIZE_OF_DEST_INFO。
需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | rtmv2.h |
程式庫 | Rtm.lib |
Dll | Rtm.dll |