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

Статья
08/24/2023

Функция 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

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

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

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