Compartir a través de

Función MprAdminServerConnect (mprapi.h)

  • Artículo

La función MprAdminServerConnect establece una conexión a un enrutador con el fin de administrar ese router. Llame a esta función antes de realizar otras llamadas al servidor. Use el identificador devuelto en llamadas posteriores para administrar interfaces en el servidor.

Sintaxis

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

Parámetros

[in, optional] lpwsServerName

Puntero a una cadena Unicode terminada en null que especifica el nombre del servidor remoto. Si este parámetro es NULL, la función devuelve un identificador al equipo local.

[out] phMprServer

Puntero a una variable HANDLE que recibe un identificador para el servidor. Use este identificador en llamadas posteriores para administrar el servidor.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_ACCESS_DENIED
 La aplicación que realiza la llamada no tiene privilegios suficientes.
RPC_S_INVALID_BINDING
 Se llamó a esta función con el parámetro phMprServer igual a NULL.
RPC_S_UNKNOWN_IF
 El equipo especificado no ejecuta el servicio Enrutamiento y RAS.

Comentarios

MprAdminIsServiceRunning debe usarse para determinar el estado del servicio RRAS en el servidor remoto. MprAdminServerConnect no consulta el servicio RRAS al establecer una conexión.

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mprapi.h
Library Mprapi.lib
Archivo DLL Mprapi.dll

Consulte también

MprAdminServerDisconnect

Funciones de administración del enrutador

Referencia de administración de enrutadores