função de retorno de chamada PINTERFACE_STATUS (routprot.h)

Artigo
08/25/2023

O gerenciador de roteadores chama a função InterfaceStatus para alterar o status de uma interface.

O tipo PINTERFACE_STATUS define um ponteiro para essa função de retorno de chamada. InterfaceStatus é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PINTERFACE_STATUS PinterfaceStatus;

DWORD PinterfaceStatus(
  [in] ULONG InterfaceIndex,
  [in] BOOL InterfaceActive,
  [in] DWORD StatusType,
  [in] PVOID StatusInfo
)
{...}

Parâmetros

[in] InterfaceIndex

Especifica o índice da interface a ser alterado.

[in] InterfaceActive

Especifica se a interface está ativa.

[in] StatusType

Especifica a nova interface status. Esse parâmetro é um dos valores a seguir.

RIS_INTERFACE_ADDRESS_CHANGE

RIS_INTERFACE_ENABLED

RIS_INTERFACE_DISABLED

RIS_INTERFACE_MEDIA_PRESENT

RIS_INTERFACE_MEDIA_ABSENT

[in] StatusInfo

Ponteiro para uma estrutura que especifica informações apropriadas para o tipo de interface status tipo. Por exemplo, se o parâmetro StatusType especificar uma alteração de endereço, o parâmetro StatusInfo apontará para uma estrutura que contém as novas informações de endereço, como IP_ADAPTER_BINDING_INFO. Esse parâmetro pode ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado deverá ser NO_ERROR.

Se a função falhar, o valor retornado deverá ser um dos seguintes códigos de erro.

Valor	Descrição
ERROR_CAN_NOT_COMPLETE	Falha não especificada.
ERROR_INVALID_PARAMETER	O parâmetro InterfaceIndex é inválido (por exemplo, nenhuma interface existe com esse índice).

Requisitos


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	routprot.h

Confira também

Addinterface

DeleteInterface

Compartilhar via