共用方式為


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

在輸入時, DestInfoRTM_DEST_INFO 結構的指標。

在輸出上, DestInfo 會填入要求的目的地資訊。

傳回值

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

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

意義
ERROR_NOT_FOUND
找不到指定的目的地。
 
 

備註

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

另請參閱

RTM_DEST_INFO

RTM_NET_ADDRESS

RtmGetExactMatchRoute

RtmGetLessSpecificDestination

RtmGetMostSpecificDestination

RtmIsBestRoute