Funzione RtmInsertInRouteList (rtmv2.h)

Articolo
03/05/2024

La funzione RtmInsertInRouteList inserisce il set specificato di route nell'elenco di route del client. Se una route è già presente in un altro elenco, la route viene rimossa dall'elenco precedente e inserita nel nuovo elenco.

Sintassi

DWORD RtmInsertInRouteList(
  [in] RTM_ENTITY_HANDLE     RtmRegHandle,
  [in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [in] UINT                  NumRoutes,
  [in] PRTM_ROUTE_HANDLE     RouteHandles
);

Parametri

[in] RtmRegHandle

Handle per il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] RouteListHandle

Gestire l'elenco di route a cui aggiungere route. Specificare NULL per rimuovere le route specificate dagli elenchi precedenti.

[in] NumRoutes

Specifica il numero di route in RouteHandles.

[in] RouteHandles

Puntatore a una matrice di handle di route da spostare dall'elenco precedente al nuovo elenco.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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

Quando le route non sono più necessarie, rilasciarle chiamando RtmReleaseRoutes.

Per il codice di esempio che usa questa funzione, vedere Usare un elenco di route Client-Specific.

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

RtmCreateRouteList

RtmDeleteRouteList

Condividi tramite