Funzione RtmGetDestInfo (rtmv2.h)

Articolo
03/01/2024

La funzione RtmGetDestInfo restituisce informazioni su una destinazione.

Sintassi

DWORD RtmGetDestInfo(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [in]  ULONG             ProtocolId,
  [in]  RTM_VIEW_SET      TargetViews,
  [out] PRTM_DEST_INFO    DestInfo
);

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] DestHandle

Gestire la destinazione per cui restituire informazioni.

[in] ProtocolId

Specifica l'identificatore del protocollo. ProtocolID non fa parte dei criteri di ricerca. Gestione tabelle di routing usa questo identificatore per determinare quali informazioni di route restituire. Ad esempio, se un client specifica l'identificatore del protocollo RIP, viene restituita la route di rip migliore, anche se una route non RIP è la route migliore per la destinazione.

Specificare RTM_BEST_PROTOCOL per restituire una route indipendentemente dal protocollo proprietario. Specificare RTM_THIS_PROTOCOL per restituire la route migliore per il protocollo chiamante.

[in] TargetViews

Specifica le visualizzazioni da cui restituire informazioni. Se il client specifica RTM_VIEW_MASK_ANY, le informazioni di destinazione vengono restituite da tutte le visualizzazioni; tuttavia, non vengono restituite informazioni specifiche della visualizzazione.

[out] DestInfo

In input, DestInfo è un puntatore a una struttura RTM_DEST_INFO .

Nell'output, DestInfo viene riempito con le informazioni di destinazione richieste.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_HANDLE	Handle non valido.

Commenti

La struttura puntata da DestInfo è una struttura di dimensioni variabili. Se il client specifica più visualizzazioni con TargetViews, le dimensioni di DestInfo aumentano per ogni visualizzazione. Usare la macro RTM_SIZE_OF_DEST_INFO per determinare la quantità di una struttura DestInfo da allocare prima di chiamare questa funzione. Usare il valore specificato per TargetViews come parametro per RTM_SIZE_OF_DEST_INFO.

Usare RtmReleaseDestInfo per rilasciare il buffer DestInfo .

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

RTM_DEST_INFO

RtmReleaseDestInfo

Condividi tramite