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

Статья
08/24/2023

Функция MprAdminUserGetInfo извлекает все сведения RAS для конкретного пользователя.

Синтаксис

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

Параметры

[in] lpszServer

Указатель на строку Юникода, указывающую имя сервера с подсистемой master учетных записей пользователей (UAS). Если сервер удаленного доступа является частью домена, компьютер с UAS является либо основным, либо резервным контроллером домена. Если сервер удаленного доступа не является частью домена, то сервер сам хранит uaS. В любом случае вызовите функцию MprAdminGetPDCServer , чтобы получить значение для этого параметра.

Если сервер сам хранит UAS, этот параметр может иметь значение NULL.

[in] lpszUser

Указатель на строку Юникода, указывающую имя пользователя, для которого требуется получить сведения о RAS.

[in] dwLevel

Этот параметр может быть равен нулю или единице.

Windows NT Server 4.0 с пакетом обновления 3 (SP3) и более поздних версий: этот параметр должен иметь нулевое значение.

[out] lpbBuffer

Указатель на структуру RAS_USER_0 или RAS_USER_1 . Вызывающий объект должен выделить (и освободить) память для этой структуры. После успешного возврата эта структура содержит данные RAS для указанного пользователя.

Windows NT Server 4.0 с пакетом обновления 3 (SP3) и более поздних версий. Если параметр dwLevel задает ноль, lpbBuffer должен указывать на структуру RAS_USER_0.

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных привилегий.
ERROR_INVALID_LEVEL	Недопустимое значение dwLevel .
ERROR_INVALID_PARAMETER	lpbBuffer имеет значение NULL
ERROR_NO_SUCH_USER	Пользователь, указанный параметром lpwsUserName , не существует на сервере, указанном в параметре lpwsServerName.

Эта функция доступна в Windows NT 4.0, если установлен распространяемый компонент RRAS. Однако версия Mprapi.dll, поставляемая с распространяемым компонентом RRAS, экспортирует функцию как RasAdminUserGetInfo , а не mprAdminUserGetInfo. Поэтому при использовании распространяемого компонента RRAS используйте LoadLibrary и GetProcAddress для доступа к этой функции.

Требования

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