管理句柄

路由表管理員會維護它所管理的所有資訊的參考計數。 這可防止路由表管理程序將任何指向已釋放記憶體的控制代碼傳回給用戶端。 每次將操作代號傳回給呼叫端時，不論是作為明確的代號還是作為資訊結構的一部分，例如 RTM_DEST_INFO，與該操作代號對應的物件參考計數都會增加。 當釋放控制代碼或資訊結構時，會相應地遞減參考計數。 當參考計數變成零時，就會釋放 物件。

RtmGetDestInfo、RtmGetEntityInfo、RtmGetRouteInfo 和 RtmGetNextHopInfo 函式會傳回資訊結構。 這些函式分別對應至 RtmReleaseDestInfo、RtmReleaseEntityInfo、RtmReleaseRouteInfo 和 RtmRelaseNextHopInfo 函式。

注意

RtmReleaseChangedDests 函式應該用來釋放呼叫 RtmGetChangedDests所傳回的控制代碼。 請勿針對已變更的目的地結構使用 RtmReleaseDests。

 

如果客戶端在釋放其餘部分時必須在信息結構中保留特定句柄，客戶端可以在釋放信息結構之前先呼叫 RtmReferenceHandles 與該句柄。 接著，您可以呼叫 RtmReleaseDestInfo、RtmReleaseEntityInfo、RtmReleaseRouteInfo 和 RtmRelaseNextHopInfo 函式來釋放句柄。