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


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

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

Синтаксис

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const LPBYTE lpbBuffer
);

Параметры

[in] lpszServer

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

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

[in] lpszUser

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

[in] dwLevel

Этот параметр может быть равен нулю или единице, что соответствует типу структуры, на который указывает параметр lpbBuffer .

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

[in] 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
Вызывающий объект не имеет достаточных привилегий.
_INVALID_LEVEL ОШИБОК
Недопустимое значение dwLevel .
ERROR_NOT_ENOUGH_MEMORY
Недостаточно ресурсов для завершения операции.
ERROR_NO_SUCH_USER
Пользователь, указанный lpwsUserName , не существует на сервере, указанном lpwsServerName.

Комментарии

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

Требования

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

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

MprAdminGetPDCServer

MprAdminUserGetInfo

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

RAS_USER_0

Справочник по администрированию службы удаленного доступа