Função MprAdminServerConnect (mprapi.h)

A função MprAdminServerConnect estabelece uma conexão com um roteador com a finalidade de administrar esse roteador. Chame essa função antes de fazer outras chamadas para o servidor. Use o identificador retornado em chamadas subsequentes para administrar interfaces no servidor.

Sintaxe

DWORD MprAdminServerConnect(
  [in, optional] LPWSTR            lpwsServerName,
  [out]          MPR_SERVER_HANDLE *phMprServer
);

Parâmetros

[in, optional] lpwsServerName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do servidor remoto. Se esse parâmetro for NULL, a função retornará um identificador para o computador local.

[out] phMprServer

Um ponteiro para uma variável HANDLE que recebe um identificador para o servidor. Use esse identificador em chamadas subsequentes para administrar o servidor.

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
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
RPC_S_INVALID_BINDING	Essa função foi chamada com o parâmetro phMprServer igual a NULL.
RPC_S_UNKNOWN_IF	O computador especificado não está executando o serviço de Roteamento e RAS.

Comentários

MprAdminIsServiceRunning deve ser usado para determinar a status do serviço RRAS no servidor remoto. MprAdminServerConnect não consulta o serviço RRAS ao estabelecer uma conexão.

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

MprAdminServerDisconnect

Funções de administração do roteador

Referência de gerenciamento de roteador