Función RtmDeleteNextHop (rtmv2.h)
La función RtmDeleteNextHop elimina un próximo salto de la lista de próximo salto.
Sintaxis
DWORD RtmDeleteNextHop(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[in] PRTM_NEXTHOP_INFO NextHopInfo
);
Parámetros
[in] RtmRegHandle
Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.
[in] NextHopHandle
Controle al próximo salto que se va a eliminar. Este parámetro es opcional y se puede establecer en NULL; si es NULL, los valores de NextHopInfo se usan para identificar el próximo salto que se va a eliminar.
[in] NextHopInfo
Puntero a una estructura que contiene información que identifica el próximo salto que se va a eliminar. Este parámetro es opcional y se puede establecer en NULL; si es NULL, el identificador de NextHopHandle se usa para identificar el próximo salto que se va a eliminar.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
El cliente que realiza la llamada no posee este próximo salto. |
|
No hay suficiente memoria para completar esta operación. |
|
No se encontró el próximo salto especificado. |
Comentarios
Si un cliente especifica nextHopHandle, el cliente no debe liberar posteriormente el identificador mediante RtmReleaseNextHops.
Requisitos
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | rtmv2.h |
| Library | Rtm.lib |
| Archivo DLL | Rtm.dll |