Funzione RtmLockDestination (rtmv2.h)

La funzione RtmLockDestination blocca o sblocca una destinazione nella tabella di routing. Usare questa funzione per proteggere una destinazione durante la modifica dei puntatori opachi.

Sintassi

DWORD RtmLockDestination(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              Exclusive,
  [in] BOOL              LockDest
);

Parametri

[in] RtmRegHandle

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

[in] DestHandle

Handle per la destinazione da bloccare.

[in] Exclusive

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

[in] LockDest

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

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 destinazione.
ERROR_INVALID_HANDLE	Handle non valido.

 

 

Commenti

Questa funzione blocca anche le route associate. Evitare di bloccare le destinazioni per lunghi periodi di tempo, perché nessun altro client può accedere alla destinazione e alle route associate fino al rilascio del blocco.

Un client può anche usare questa funzione durante la lettura delle informazioni per una destinazione, impedendo al tempo stesso le modifiche durante l'operazione di lettura del client. In questo caso, prendere in considerazione l'uso di RtmGetDestInfo .

Per il codice di esempio che usa questa funzione, vedere Aggiornare una route sul posto usando RtmUpdateAndUnlockRoute.

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

RtmGetOpaqueInformationPointer