Compartilhar via


Função MprAdminInterfaceTransportRemove (mprapi.h)

A função MprAdminInterfaceTransportRemove remove um transporte (por exemplo, IP ou IPX) de uma interface especificada.

Sintaxe

DWORD MprAdminInterfaceTransportRemove(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId
);

Parâmetros

[in] hMprServer

Identificador para o roteador do qual o transporte está sendo removido. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hInterface

Identificador para a interface da qual o transporte está sendo removido. Obtenha esse identificador chamando MprAdminInterfaceCreate.

[in] dwTransportId

Um valor DWORD que descreve o tipo de transporte a ser removido. Os valores aceitáveis para dwTransportId estão listados na tabela a seguir.

Valor Transporte (Família de Protocolos)
PID_ATALK Appletalk
PID_IP Protocolo internet versão 4
PID_IPX Troca de Pacotes da Internet
PID_NBF Protocolo NetBIOS Frames
PID_IPV6 Windows Server 2008 ou posterior: Protocolo de Internet versão 6

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 códigos de erro a seguir.

Valor Significado
ERROR_ACCESS_DENIED
O aplicativo de chamada não tem privilégios suficientes.
ERROR_INTERFACE_CONNECTED
A interface especificada é uma interface de discagem de demanda e está conectada no momento.
ERROR_INVALID_HANDLE
O valor hInterface é inválido.
ERROR_NO_SUCH_INTERFACE
O transporte especificado não está em execução na interface especificada.
ERROR_UNKNOWN_PROTOCOL_ID
O valor dwTransportId não corresponde a nenhum transporte com suporte.

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 mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

MprAdminInterfaceCreate

MprAdminInterfaceTransportAdd

MprAdminServerConnect

Funções de administração do roteador

Referência de gerenciamento de roteador