Funzione RtmLockRoute (rtmv2.h)

La funzione RtmLockRoute blocca o sblocca una route nella tabella di routing. Ciò protegge la route mentre un client apporta le modifiche necessarie ai puntatori di route opachi di proprietà del client.

Sintassi

DWORD RtmLockRoute(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ROUTE_HANDLE  RouteHandle,
  [in]  BOOL              Exclusive,
  [in]  BOOL              LockRoute,
  [out] PRTM_ROUTE_INFO   *RoutePointer
);

Parametri

[in] RtmRegHandle

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

[in] RouteHandle

Gestire la route da bloccare.

[in] Exclusive

Specifica se bloccare o sbloccare la route in modalità esclusiva (TRUE) o condivisa (FALSE).

[in] LockRoute

Specifica se bloccare o sbloccare la route. Specificare TRUE per bloccare la route; specificare FALSE per sbloccarlo.

[out] RoutePointer

Se deve essere restituito un puntatore: all'input, RoutePointer è un puntatore a NULL. Nell'output, se il client è proprietario della route, RoutePointer riceve un puntatore all'hop successivo; in caso contrario, RoutePointer rimane invariato.

Se non è necessario restituire un handle: in input , RoutePointer è NULL.

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_ACCESS_DENIED	Il client chiamante non possiede questa route.
ERROR_INVALID_HANDLE	Handle non valido.

 

 

Commenti

Non chiamare altre funzioni RTMv2 finché la route non viene sbloccata da una chiamata a RtmLockRoute e il parametro LockRoute è impostato su FALSE o una chiamata a RtmUpdateAndUnlockRoute.

Attualmente, questa funzione blocca l'intera destinazione, non solo la route.

I client possono modificare solo i membri Neighbor, PrefInfo, BelongsToViews, EntitySpecificInfo e NextHopsList della struttura RTM_ROUTE_INFO .

Se uno di questi valori viene modificato, il client deve chiamare RtmUpdateAndUnlockRoute per notificare alla gestione tabelle di routing le modifiche.

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_ROUTE_INFO

RtmAddRouteToDest

RtmDeleteRouteToDest

RtmGetRoutePointer

RtmHoldDestination

RtmUpdateAndUnlockRoute