Função MprAdminTransportCreate (mprapi.h)

Artigo
08/24/2023

A função MprAdminTransportCreate carrega um novo transporte e inicia o gerenciador de roteadores para o transporte.

Sintaxe

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

Parâmetros

[in] hMprServer

Manipule para o roteador no qual definir as informações. Obtenha esse identificador chamando MprAdminServerConnect.

[in] dwTransportId

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

Valor	Transporte (Família de Protocolos)
PID_ATALK	Appletalk
PID_IP	Protocolo de 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, optional] lpwsTransportName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do transporte.

[in] pGlobalInfo

Ponteiro para um buffer que especifica informações globais para o transporte. Use as Funções de Cabeçalho de Informações para manipular cabeçalhos de informações.

[in] dwGlobalInfoSize

Especifica o tamanho, em bytes, dos dados apontados pelo parâmetro pGlobalInfo .

[in, optional] pClientInterfaceInfo

Ponteiro para um buffer que especifica informações padrão da interface do cliente para o transporte.

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não definirá as informações padrão da interface do cliente.

[in, optional] dwClientInterfaceInfoSize

Especifica o tamanho, em bytes, do buffer apontado pelo parâmetro pClientInterfaceInfo .

[in] lpwsDLLPath

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o caminho para a DLL para o transporte.

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
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_INVALID_PARAMETER	O parâmetro pGlobalInfo e o parâmetro pClientInterfaceInfo são NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_PROTOCOL_ALREADY_INSTALLED	O transporte especificado já está em execução no roteador especificado.
ERROR_UNKNOWN_PROTOCOL_ID	O valor dwTransportId não corresponde a nenhum protocolo de 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

MprAdminTransportGetInfo

MprAdminTransportSetInfo

Compartilhar via