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 |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
Essa função foi chamada com o parâmetro phMprServer igual a NULL. |
|
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 |