Функция MprAdminUserGetInfo (mprapi.h)
Функция 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.
Если функция завершается ошибкой, возвращается одно из следующих значений.
| Значение | Значение |
|---|---|
|
Вызывающий объект не имеет достаточных привилегий. |
|
Недопустимое значение dwLevel . |
|
lpbBuffer имеет значение NULL |
|
Пользователь, указанный параметром 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 |