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

Статья
08/24/2023

Функция MprAdminIsServiceInitialized проверяет, запущена ли служба RRAS на указанном сервере, если вызывающий процесс имеет доступ.

Синтаксис

DWORD MprAdminIsServiceInitialized(
  [in] LPWSTR lpwsServerName,
  [in] BOOL   *fIsServiceInitialized
);

Параметры

[in] lpwsServerName

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

[in] fIsServiceInitialized

В выходных данных — указатель на boOL, указывающий, запущена ли служба RRAS на сервере в lpwsServerName:

Значение	Значение
TRUE	Служба выполняется на указанном сервере.
FALSE	Служба не запущена на указанном сервере, и (или) вызывающий процесс не имеет доступа к службе RRAS.

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Параметр fIsServiceInitialized имеет значение NULL.
ERROR_SERVICE_NOT_ACTIVE	Служба RRAS не запущена на сервере.
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.

Требования


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

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

MprAdminIsServiceRunning

MprConfigBufferFree

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

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

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