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

  • Artigo

A função AddInterface adiciona uma interface a ser gerenciada pelo protocolo de roteamento. O protocolo deve considerar que a interface está em um estado desabilitado. O gerenciador de roteador habilita a interface chamando InterfaceStatus com o sinalizador RIS_INTERFACE_ENABLED.

Quando um usuário chama MprAdminInterfaceTransportAdd, o gerenciador de interface dinâmica para o transporte chama o gerenciador de roteador (para o transporte) que chama essa função para cada um dos protocolos de roteamento associados a esse transporte.

Sintaxe

PADD_INTERFACE PaddInterface;

DWORD PaddInterface(
  [in] LPWSTR InterfaceName,
  [in] ULONG InterfaceIndex,
  [in] NET_INTERFACE_TYPE InterfaceType,
  [in] DWORD MediaType,
  [in] WORD AccessType,
  [in] WORD ConnectionType,
  [in] PVOID InterfaceInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

Parâmetros

[in] InterfaceName

Ponteiro para uma cadeia de caracteres Unicode. A cadeia de caracteres contém um nome que identifica exclusivamente a interface no conjunto de interfaces configuradas no roteador.

[in] InterfaceIndex

Especifica a interface no conjunto de interfaces configuradas no roteador.

[in] InterfaceType

Especifica o tipo da interface.

Valor Significado
PERMANENTE
 Conectividade permanente (por exemplo, LAN, Retransmissão de Quadros).
DEMAND_DIAL
 Conectividade de discagem de demanda (analógico, ISDN, PPTP, FR comutado).
LOCAL_WORKSTATION_DIAL
 Somente conectividade de estação de trabalho local.
REMOTE_WORKSTATION_DIAL
 Somente conectividade de estação de trabalho remota.

[in] MediaType

Reservado para uso futuro.

[in] AccessType

Reservado para uso futuro.

[in] ConnectionType

Reservado para uso futuro.

[in] InterfaceInfo

Ponteiro para um buffer que especifica informações de configuração definidas pelo protocolo associadas à interface. Essas informações são privadas para o protocolo de roteamento.

[in] StructureVersion

Especifica a versão das estruturas de informações apontadas pelo parâmetro InterfaceInfo . Em alguns casos, isso é igual à versão do protocolo de roteamento.

[in] StructureSize

Especifica o tamanho de cada uma das estruturas de informações apontadas pelo parâmetro InterfaceInfo . Como algumas estruturas de informações contêm membros de comprimento variável, o protocolo de roteamento não é necessariamente capaz de determinar o tamanho das informações da versão.

[in] StructureCount

Especifica uma contagem do número de estruturas de informações apontadas pelo parâmetro InterfaceInfo . Esse parâmetro é sempre um.

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 Descrição
ERROR_CAN_NOT_COMPLETE
 Falha na tentativa de adicionar a interface.
ERROR_INVALID_PARAMETER
 O parâmetro InterfaceIndex é inválido (por exemplo, uma interface com esse índice já existe), ou um dos parâmetros apontados por InterfaceInfo é inválido.
 
 

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

Confira também

DeleteInterface

Funções de interface de protocolo de roteamento

Referência da interface do protocolo de roteamento