На главную

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 | Скачать Вниз

NetUserSetInfo



The NetUserSetInfo function sets the parameters of a user account.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetUserSetInfo on a remote server or on a computer that has local security enabled. A user may call NetUserSetInfo to set certain information on his or her own account.

NET_API_STATUS NetUserSetInfo(

LPWSTR servername,
LPWSTR username,
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.

username

Pointer to a Unicode string containing the name of the user account to set information.

level

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

Value Meaning
0 The buf parameter points to a USER_INFO_0 structure.
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.
21 The buf parameter points to a USER_INFO_21 structure.
22 The buf parameter points to a USER_INFO_22 structure.
1003 The buf parameter points to a USER_INFO_1003 structure.
1005 The buf parameter points to a USER_INFO_1005 structure.
1006 The buf parameter points to a USER_INFO_1006 structure.
1007 The buf parameter points to a USER_INFO_1007 structure.
1008 The buf parameter points to a USER_INFO_1008 structure.
1009 The buf parameter points to a USER_INFO_1009 structure.
1010 The buf parameter points to a USER_INFO_1010 structure.
1011 The buf parameter points to a USER_INFO_1011 structure.
1012 The buf parameter points to a USER_INFO_1012 structure.
1013 The buf parameter points to a USER_INFO_1013 structure.
1014 The buf parameter points to a USER_INFO_1014 structure.
1017 The buf parameter points to a USER_INFO_1017 structure.
1020 The buf parameter points to a USER_INFO_1020 structure.
1024 The buf parameter points to a USER_INFO_1024 structure.
1051 The buf parameter points to a USER_INFO_1051 structure.
1053 The buf parameter points to a USER_INFO_1053 structure.


buf

Pointer to the buffer in which the data set with the level parameter is stored. The returned buffer should be deallocated using the NetApiBufferFree function.

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.



Remarks

The NetUserSetInfo function can be called to change a user's password only by users or applications having administrative privileges. However, the password can be changed by users or applications knowing the current password and calling NetUserChangePassword. When an administrator calls NetUserSetInfo, the only restriction applied is that the new password length must be consistent with system modals.
Members of the Administrators local group can set any modifiable element. All users can set the usri2_usr_comment, usri2_parms, and usri2_country_code, elements of the user_info_2 data structure for their own accounts. To do this, the user must use the ParmNum parameter and cannot pass the whole structure.

A member of the Account Operator's local group cannot set details for an Administrators class account, give an existing account Administrator privilege, or change the operator privilege of any account. If attempting to change the privilege level or disable the last account with Administrator privilege in the database, NetUserSetInfo fails and returns NERR_LastAdmin.
You can call NetUserSetInfo with USER_INFO_1 and specify a value using the usri1_name member. However, that value will be ignored. The correct way to specify the new name of the group is to call NetUserSetInfo with USER_INFO_0 and specify a value using the usri0_name member.

The NetUserSetInfo function cannot be used to change the home directory for user accounts that were not created by the LAN Manager server.

Return Values

If the function is successful, it returns 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 The computer name is invalid.
NERR_NotPrimary The operation is allowed only on the primary domain controller of the domain.
NERR_SpeGroupOp The operation is not allowed on specified special groups, which are user groups, admin groups, local groups, or guest groups.
NERR_LastAdmin The operation is not allowed on the last administrative account.
NERR_BadPassword The share name or password is invalid.
NERR_PasswordTooShort The password is shorter than required.
NERR_UserNotFound The user name could not be found.


See Also

NetUserGetInfo


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

NetUserSetInfo



Функция NetUserSetInfo устанавливает параметры счета потребителя.

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

Только участники Администраторов или локальной группы Учетных Операторов могут успешно выполнить NetUserSetInfo в дистанционном сервере или в компьютере, что приспособился локальную безопасность. Пользователь может назвать NetUserSetInfo, чтобы устанавливать определенную информацию о его или ее собственном счете.

NET_API_STATUS NetUserSetInfo(

LPWSTR servername, ИМЯ пользователя LPWSTR, DWORD выравнивается, буфер LPBYTE, parm_err LPDWORD
);


Параметры

servername

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

имя пользователя

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

уровень

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

Значение Величины
0 Параметр буфера указывает на структуру USER_INFO_0.
1 Параметр буфера указывает на структуру USER_INFO_1.
2 Параметр буфера указывает на структуру USER_INFO_2.
3 Параметр буфера указывает на структуру USER_INFO_3.
21 Параметр буфера указывает на структуру USER_INFO_21.
22 Параметр буфера указывает на структуру USER_INFO_22.
1003 Параметр буфера указывает на структуру USER_INFO_1003.
1005 Параметр буфера указывает на структуру USER_INFO_1005.
1006 Параметр буфера указывает на структуру USER_INFO_1006.
1007 Параметр буфера указывает на структуру USER_INFO_1007.
1008 Параметр буфера указывает на структуру USER_INFO_1008.
1009 Параметр буфера указывает на структуру USER_INFO_1009.
1010 Параметр буфера указывает на структуру USER_INFO_1010.
1011 Параметр буфера указывает на структуру USER_INFO_1011.
1012 Параметр буфера указывает на структуру USER_INFO_1012.
1013 Параметр буфера указывает на структуру USER_INFO_1013.
1014 Параметр буфера указывает на структуру USER_INFO_1014.
1017 Параметр буфера указывает на структуру USER_INFO_1017.
1020 Параметр буфера указывает на структуру USER_INFO_1020.
1024 Параметр буфера указывает на структуру USER_INFO_1024.
1051 Параметр буфера указывает на структуру USER_INFO_1051.
1053 Параметр буфера указывает на структуру USER_INFO_1053.


буфер

Указатель в буфер в котором данные установленные параметром уровня загружены. Возвращанный буфер должен быть освобожден используя функцию NetApiBufferFree.

parm_err

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



Замечания

Функция NetUserSetInfo может быть названа, чтобы изменять пароль пользователя только пользователями или приложениями, имеющими административные привилегии. Тем не менее, пароль может быть изменен пользователями или приложениями, знающими текущий пароль и вызов NetUserChangePassword. Когда администратор называет NetUserSetInfo, прикладное единственное ограничение - в том, что новая длина пароля должна быть соответствующей системному модальному.
Участники локальной группы Администраторов могут установить любой модифицируемый элемент. Все пользователи могут установить usri2_usr_comment, usri2_parms, и usri2_country_code, элементы user_info_2 структуры данных для своих собственных отчетностей. Чтобы делать это, пользователь должен использовать параметр ParmNum и не может передать целую структуру.

Элемент локальной группы Учетного Оператора не может установить детали для счета класса Администраторов, давать существующую учетную привилегию Администратора или изменять привилегию оператора любого счета. При попытке изменять уровень привилегии или выводить из строя последний счет с привилегией Администратора в базе данных, NetUserSetInfo терпит неудачу и возвращает NERR_LastAdmin.
Вы можете назвать NetUserSetInfo с USER_INFO_1 и определять величину используя usri1_name элемент. Тем не менее, эта величина будет проигнорирована. Правильный путь определять что новое имя группы - называть NetUserSetInfo с USER_INFO_0 и определять величину используя usri0_name элемент.

Функция NetUserSetInfo не может быть использована, чтобы изменять домашний директорий для отчетностей пользователя, что не были созданы сервером Менеджера LAN.

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

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

Значение Величины
ERROR_ACCESS_DENIED пользователь нет имеет доступ к запрошенной информации.
NERR_InvalidComputer компьютерное имя недействительно.
NERR_NotPrimary операция допускается только на первичном доменном диспетчере области.
NERR_SpeGroupOp операция не допущена в определенные специальные группы, которые - группы пользователя, групп администрации, локальных групп, или группы гостя.
NERR_LastAdmin операция не допущена на последний административный счет.
NERR_BadPassword акционерное имя или пароль недействителен.
NERR_PasswordTooShort пароль - короче чем требовался.
NERR_UserNotFound имя пользователя не могло обнаруживано.


Смотри Также

NetUserGetInfo


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