Поделиться через

Функция MprAdminServerConnect (mprapi.h)

  • Статья

Функция MprAdminServerConnect устанавливает подключение к маршрутизатору для администрирования этого маршрутизатора. Вызовите эту функцию перед выполнением других вызовов сервера. Используйте дескриптор, возвращенный в последующих вызовах, для администрирования интерфейсов на сервере.

Синтаксис

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

Параметры

[in, optional] lpwsServerName

Указатель на строку Юникода, завершающуюся null, которая указывает имя удаленного сервера. Если этот параметр имеет значение NULL, функция возвращает дескриптор локальному компьютеру.

[out] phMprServer

Указатель на переменную HANDLE , которая получает дескриптор сервера. Используйте этот дескриптор в последующих вызовах для администрирования сервера.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет достаточных привилегий.
RPC_S_INVALID_BINDING
 Эта функция была вызвана с параметром phMprServer , равным NULL.
RPC_S_UNKNOWN_IF
 На указанном компьютере не выполняется служба маршрутизации и RAS.

Комментарии

Для определения состояния службы RRAS на удаленном сервере необходимо использовать MprAdminIsServiceRunning. MprAdminServerConnect не запрашивает службу RRAS при установке подключения.

Требования

   
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mprapi.h
Библиотека Mprapi.lib
DLL Mprapi.dll

См. также раздел

MprAdminServerDisconnect

Функции администрирования маршрутизатора

Справочник по управлению маршрутизаторами