На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

NetUserAdd



The NetUserAdd function adds a user account and assigns a password and privilege level.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetUserAdd. Only members of the Administrators local group can add an Administrators privilege account.

NET_API_STATUS NetUserAdd(

LPWSTR servername,
DWORD level,
LPBYTE buf,
LPDWORD parm_err
);


Parameters

servername

Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.

level

Specifies one of the following values to set the level of information provided.

Value Meaning
1 The buf parameter points to a USER_INFO_1 structure.
2 The buf parameter points to a USER_INFO_2 structure.
3 The buf parameter points to a USER_INFO_3 structure.


buf

Pointer to the buffer in which the data set with the level parameter is stored.

parm_err

Optional pointer to a DWORD that contains the index of the first parameter that causes ERROR_INVALID_PARAMETER. If NULL, the parameter is not returned on error.



Return Values

If the function returns account information, the return value is NERR_Success.
If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The user does not have access to the requested information.
NERR_InvalidComputer Thiecomputer name is invalid.
NERR_NotPrimary The operation is allowed only on the primary domain controller of the domain.
NERR_GroupExists The group already exists.
NERR_UserExists The user account already exists.
NERR_PasswordTooShort The password is shorter than required.


Remarks

Server users must use a system in which the server creates a WINDOWS NT system account for the new user. The creation of this account is controlled by several parameters in the server's LANMAN.INI file.
If the newly added server user name already exists as a Windows NT system user, the useril_home_dir member of the USER_INFO_1 structure is ignored. The NetUserAdd function supports USER_INFO_1 and USER_INFO_2 structures. Using members of USER_INFO_1 initializes default values in USER_INFO_2 and USER_INFO_3 structures.

Subsequent NetUserSetInfo calls can change the default values. The following are possible default values.

Member Default Value
usriX_auth_flags None (0)
usriX_full_name usri1_name
usriX_usr_comment None (null string)
usriX_parms None (null string)
usriX_workstations All (null string)
usriX_acct_expires Never (TIMEQ_FOREVER)
usriX_max_storage Unlimited (USER_MAXSTORAGE_UNLIMITED)
usriX_logon_hours Logon allowed at any time (each element 0xFF; all bits set to 1)
usriX_logon_server Any domain controller (\\*)
usriX_country_code Current (country_code on the server
usriX_code_page 0


See Also

NetUserEnum, NetUserSetInfo, NetUserDel


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

NetUserAdd



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

Требования Безопасности

Только участники Администраторов или локальной группы Учетных Операторов могут успешно выполнить NetUserAdd. Только участники локальной группы Администраторов могут добавить счет привилегии Администраторов.

NET_API_STATUS NetUserAdd(

LPWSTR servername, УРОВЕНЬ DWORD, буфер LPBYTE, parm_err LPDWORD
);


Параметры

servername

Указатель в строку Уникода, содержащую имя дистанционного сервера на котором функция должна выполняться. НЕДЕЙСТВИТЕЛЬНЫЙ указатель или строка определяет локальный компьютер.

уровень

Определяет одно из следующего величин, чтобы устанавливать уровень предусмотренной информации.

Значение Величины
1 Параметр буфера указывает на структуру USER_INFO_1.
2 Параметр буфера указывает на структуру USER_INFO_2.
3 Параметр буфера указывает на структуру USER_INFO_3.


буфер

Указатель в буфер в котором данные установленные параметром уровня загружены.

parm_err

Дополнительный указатель на DWORD, которое содержит индекс первого параметра, который вызывает ERROR_INVALID_PARAMETER. Если НЕДЕЙСТВИТЕЛЬНО, параметр не возвращан на ошибку.



Обратные Величины

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

Значение Величины
ERROR_ACCESS_DENIED пользователь нет имеет доступ к запрошенной информации.
имя NERR_InvalidComputer Thiecomputer недействительно.
NERR_NotPrimary операция допускается только на первичном доменном диспетчере области.
NERR_GroupExists группа уже существует.
NERR_UserExists счет пользователя уже существует.
NERR_PasswordTooShort пароль - короче чем требовался.


Замечания

Пользователи Сервера должны использовать систему в которой сервер создается, система WINDOWS NT принимает во внимание нового пользователя. Создание этого счета управлялось несколькими параметрами в файле сервера LANMAN.INI.
Если имя пользователя вновь дополнительного сервера уже существует как системный пользователь Windows NT, useril_home_dir элемент структуры USER_INFO_1 проигнорирован. Функция NetUserAdd поддерживает USER_INFO_1 и структуры USER_INFO_2. Использование участников USER_INFO_1 инициализирует значение по умолчанию в USER_INFO_2 и структурах USER_INFO_3.

Последующий NetUserSetInfo называет может изменить значение по умолчанию. Следующее является возможным значением по умолчанию.

Элемент Default Value usriX_auth_flags Ничто (0) usriX_full_name usri1_name usriX_usr_comment Ничто (недействительная строка) usriX_parms Ничто (недействительная строка) usriX_workstations Все (недействительная строка) usriX_acct_expires Никогда (TIMEQ_FOREVER) usriX_max_storage Неограниченный (USER_MAXSTORAGE_UNLIMITED) Ввод usriX_logon_hours допускал в любое время (каждый элемент 0xFF; все биты установленные на 1) usriX_logon_server Любого доменного диспетчера (\\*) Течение usriX_country_code (country_code в сервере usriX_code_page 0


Смотри Также

NetUserEnum, NetUserSetInfo, NetUserDel


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz