Função MprAdminInterfaceTransportAdd (mprapi.h)
A função MprAdminInterfaceTransportAdd adiciona um transporte (por exemplo, IP ou IPX) a uma interface especificada.
Sintaxe
DWORD MprAdminInterfaceTransportAdd(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwTransportId,
[in] LPBYTE pInterfaceInfo,
[in] DWORD dwInterfaceInfoSize
);
Parâmetros
[in] hMprServer
Identificador para o roteador no qual as informações estão sendo adicionadas. Obtenha esse identificador chamando MprAdminServerConnect.
[in] hInterface
Identificador para a interface na qual o transporte está sendo adicionado. Esse identificador é obtido por uma chamada anterior para MprAdminInterfaceCreate.
[in] dwTransportId
Um valor DWORD que descreve o tipo de transporte a ser adicionado à interface. 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 |
[in] pInterfaceInfo
Ponteiro para um cabeçalho de informações que especifica informações de interface para esse transporte. Use as Funções de Cabeçalho de Informações para manipular cabeçalhos de informações.
[in] dwInterfaceInfoSize
Especifica o tamanho, em bytes, das informações apontadas por pInterfaceInfo.
Valor retornado
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 |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
O valor hInterface é inválido. |
|
O parâmetro pInterfaceInfo é NULL. |
|
O valor dwTransportId não corresponde a nenhum transporte com suporte. |
Comentários
O parâmetro dwTransportId também especifica o gerenciador de roteador porque um roteador usa um gerenciador de roteador diferente para cada transporte.
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 | mprapi.h |
| Biblioteca | Mprapi.lib |
| DLL | Mprapi.dll |
Confira também
MprAdminInterfaceTransportRemove