Funzione RtmHoldDestination (rtmv2.h)
La funzione RtmHoldDestination contrassegna una destinazione da inserire nello stato di blocco per un determinato periodo di tempo. Un blocco si verifica solo se l'ultima route per la destinazione in qualsiasi visualizzazione viene eliminata.
I protocolli di routing che usano stati di blocco continuano a annunciare l'ultima route fino alla scadenza del blocco, anche se le route più recenti arrivano nel frattempo. La route viene pubblicizzata come route eliminata. Le route più recenti sono tuttavia usate dai protocolli di routing per scopi di inoltro. Le nuove route vengono annunciate alla scadenza del blocco.
Sintassi
DWORD RtmHoldDestination(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_DEST_HANDLE DestHandle,
[in] RTM_VIEW_SET TargetViews,
[in] ULONG HoldTime
);
Parametri
[in] RtmRegHandle
Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.
[in] DestHandle
Gestire la destinazione da contrassegnare per la conservazione.
[in] TargetViews
Specifica le visualizzazioni in cui contenere la destinazione.
[in] HoldTime
Specifica quanto tempo, in millisecondi, per contenere la destinazione.
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 |
|---|---|
|
Il tempo di attesa specificato era zero. |
|
Handle non valido. |
Commenti
Tutte le route in uno stato di blocco vengono mantenute per tutte le visualizzazioni per un singolo tempo di blocco massimo, indipendentemente dal valore di HoldTime specificato.
Per il codice di esempio che usa questa funzione, vedere Usare route Hold-Down Stato.
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 |