Função RtmLockNextHop (rtmv2.h)
A função RtmLockNextHop bloqueia ou desbloqueia um próximo salto. Essa função deve ser chamada pelo proprietário do próximo salto para bloquear o próximo salto antes de fazer alterações no próximo salto. Um ponteiro para o próximo salto é retornado.
Sintaxe
DWORD RtmLockNextHop(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[in] BOOL Exclusive,
[in] BOOL LockNextHop,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
Parâmetros
[in] RtmRegHandle
Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.
[in] NextHopHandle
Manipule para o próximo salto para bloquear ou desbloquear.
[in] Exclusive
Especifica se o próximo salto deve ser bloqueado ou desbloqueado em um modo exclusivo (TRUE) ou compartilhado (FALSE).
[in] LockNextHop
Especifica se o próximo salto deve ser bloqueado ou desbloqueado. Especifique TRUE para bloquear o próximo salto; especifique FALSE para desbloqueá-lo.
[out] NextHopPointer
Na entrada, NextHopPointer é um ponteiro para NULL.
Na saída, se o cliente possuir o próximo salto, NextHopPointer receberá um ponteiro para o próximo salto; caso contrário, NextHopPointer permanecerá inalterado.
Retornar valor
Se a função for bem-sucedida, o valor retornado será NO_ERROR.
Se a função falhar, o valor retornado será um dos seguintes códigos de erro.
| Valor | Significado |
|---|---|
|
O cliente de chamada não possui este próximo salto. |
|
O próximo salto especificado não foi encontrado. |
Comentários
Os clientes não podem alterar os membros NextHopAddress e InterfaceIndex da estrutura RTM_NEXTHOP_INFO ; esses valores são usados para identificar exclusivamente um próximo salto.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | rtmv2.h |
| Biblioteca | Rtm.lib |
| DLL | Rtm.dll |