На главную

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

USER_INFO_3



The level 3 data structure is valid only to Windows NT servers and not LAN Manager 2.x servers.

typedef struct _USER_INFO_3 {
LPWSTR usri3_name;
LPWSTR usri3_password;
DWORD usri3_password_age;
DWORD usri3_priv;
LPWSTR usri3_home_dir;
LPWSTR usri3_comment;
DWORD usri3_flags;
LPWSTR usri3_script_path;
DWORD usri3_auth_flags;
LPWSTR usri3_full_name;
LPWSTR usri3_usr_comment;
LPWSTR usri3_parms;
LPWSTR usri3_workstations;
DWORD usri3_last_logon;
DWORD usri3_last_logoff;
DWORD usri3_acct_expires;
DWORD usri3_max_storage;
DWORD usri3_units_per_week;
PBYTE usri3_logon_hours;
DWORD usri3_bad_pw_count;
DWORD usri3_num_logons;
LPWSTR usri3_logon_server;
DWORD usri3_country_code;
DWORD usri3_code_page;
DWORD usri3_user_id;
DWORD usri3_primary_group_id;
LPWSTR usri3_profile;
LPWSTR usri3_home_dir_drive;
DWORD usri3_password_expired;
}USER_INFO_3, *PUSER_INFO_3, *LPUSER_INFO_3;



Members

usri3_name

Specifies the name of the user account. For NetUserSetInfo, this member is ignored. The number of characters in the name cannot exceed the value of UNLEN.

usri3_password

The password for the user specified in the usri3_name member. The length cannot exceed PWLEN bytes. The NetUserEnum and NetUserGetInfo functions return a NULL pointer to maintain password security. By convention, Windows NT limits the length of passwords to LM20_PWLEN characters. This convention allows LAN Manager, Windows 3.x, Windows for Workgroups 3.x, and Windows 95 clients to access a Windows NT server using the account.

usri3_password_age

Specifies the number of seconds elapsed since the usri3_password member was last changed. The NetUserAdd and NetUserSetInfo functions ignore this member.

usri3_priv

One of three values to specify the level of privilege assigned the usri3_name member. The NetUserAdd and NetUserSetInfo functions ignore this member. This member can be one of the following values:

Value Meaning
USER_PRIV_GUEST Guest
USER_PRIV_USER User
USER_PRIV_ADMIN Administrator


usri3_home_dir

Points to a Unicode string containing the path of the home directory of the user specified in user_name. The string can be null.

usri3_comment

Points to a Unicode string that contains a comment. The string can be a null string, or it can have any number of characters before the terminating null character.

usri3_flags

Contains values that determine several features. This member can be any of the following values:

Value Meaning
UF_SCRIPT The logon script executed. This value must be set for LAN Manager 2.0 or Windows NT.
UF_ACCOUNTDISABLE The user's account is disabled.
UF_HOMEDIR_REQUIRED The home directory is required. This value is ignored in Windows NT.
UF_PASSWRD_NOTREQD No password is required.
UF_PASSWRD_CANT_CHANGE The user cannot change the password.
UF_LOCKOUT The account is currently locked out. For NetUserSetInfo, this value can be cleared to unlock a previously locked account. This value cannot be used to lock a previously unlocked account.
UF_DONT_EXPIRE_PASSWORD Represents the password, which should never expire on the account. This value is valid only for Windows NT.


The following values describe the account type. Only one value can be set. You cannot change the account type using the NetUserSetInfo function.

Value Meaning
UF_NORMAL_ACCOUNT This is a default account type that represents a typical user.
UF_TEMP_DUPLICATE_ACCOUNT This is an account for users whose primary account is in another domain. This account provides user access to this domain, but not to any domain that trusts this domain. The User Manager refers to this account type as a local user account.
UF_WORKSTATION_TRUST_ACCOUNT This is a computer account for a Windows NT Workstation or Windows NT Server that is a member of this domain.
UF_SERVER_TRUST_ACCOUNT This is a computer account for a Windows NT Backup Domain Controller that is a member of this domain.
UF_INTERDOMAIN_TRUST_ACCOUNT This is a permit to trust account for a Windows NT domain that trusts other domains.


usri3_script_path

Points to a Unicode string specifying the path of the user's logon script, .CMD, .EXE, or .BAT file. The string can be null.

usri3_auth_flags

Specifies an unsigned long integer that contains values that specify the user's operator privileges.

Windows NT: For Windows NT servers, NetUserAdd and NetUserSetInfo functions ignore this member.

For NetUserGetInfo or NetUserEnum, the appropriate value is returned based on the local group membership. If the user is a member of Print Operations, AF_OP_PRINT is set. If the user is a member of Server Operations, AF_OP_SERVER is set. If the user is a member of the Account Operations, AF_OP_ACCOUNTS is set. AF_OP_COMM is never set.
The NetUserAdd and NetUserSetInfo functions ignore this member.
This member can be one of the following values:

Value Meaning
AF_OP_PRINT The print operator privilege is enabled.
AF_OP_COMM The communications operator privilege is enabled.
AF_OP_SERVER The server operator privilege is enabled.
AF_OP_ACCOUNTS The accounts operator privilege is enabled.


usri3_full_name

Points to a Unicode string that contains the full name of the user. This string can be a null string, or it can have any number of characters before the terminating null character.

usri3_usr_comment

Points to a Unicode string that contains a user comment. This string can be a null string, or it can have any number of characters before the terminating null character.

usri3_parms

Points to a Unicode string that is set aside for use by applications. This string can be a null string, or it can have any number of characters before the terminating null character. Microsoft products use this member to store user configuration information. Do not modify this information.

usri3_workstations

Points to a Unicode string that contains the names of workstations from which the user can log on. As many as eight workstations can be specified; the names must be separated by commas (,). If you do not want to restrict the number of workstations, use a null string. To disable logons from all workstations to this account, set the UF_ACCOUNTDISABLE value in the usri*_flags member.

usri3_last_logon

Specifies when the last logon occurred. This value is stored as the number of seconds elapsed since 00:00:00, January 1, 1970. This member is ignored in NetUserAdd and NetUserSetInfo calls. This member is maintained separately on each Backup Domain Controller (BDC) in the domain. To get an accurate value, each BDC in the domain must be queried, and the largest value is used.

usri3_last_logoff

Specifies when the last logoff occurred. This value is stored as the number of seconds elapsed since 00:00:00, January 1, 1970. A value of zero means that the last logoff time is unknown. This member is maintained separately on each Backup Domain Controller (BDC) in the domain. To get an accurate value, each BDC in the domain must be queried, and the largest value is used.

usri3_acct_expires

Specifies when the account will expire. This value is stored as the number of seconds elapsed since 00:00:00, January 1, 1970. A value of TIMEQ_FOREVER indicates that the account never expires.

usri3_max_storage

Specifies the maximum amount of disk space the user can use. Use the value specified in USER_MAXSTORAGE_UNLIMITED to use all available disk space.

usri3_units_per_week

Specifies the number of equal-length time units into which the week is divided in order to compute the length of the bit string in usri3_logon_hours. This value must be UNITS_PER_WEEK for LAN Manager 2.0. This element is ignored in NetUserAdd and NetUserSetInfo calls. For Windows NT services, the units must be one of the following: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK, or SAM_MINUTES_PER_WEEK.

usri3_logon_hours

Points to a 21-byte (168 bits) bit string that specifies the times during which the user can log on. Each bit represents a unique hour in the week. The first bit (bit 0, word 0) is Sunday, 0:00 to 0:59; the second bit (bit 1, word 0) is Sunday, 1:00 to 1:59; and so on. A null pointer in this member for NetUserAdd calls means there is no time restriction. A null pointer in this member for NetUserSetInfo calls means that no change is to be made.



Note Bit 0 in word 0 represents Sunday from 0:00 to 0:59 only if you are in the GMT time zone. In all other cases you must adjust the bits according to your time zone offset (for example, GMT minus 8 hours for PST).



usri3_bad_pw_count

Specifies the number of times the user tried to log on to the account using an incorrect password. A value of 0xFFFFFFFF indicates that the value is unknown. This member is ignored in NetUserAdd and NetUserSetInfo calls. This member is maintained separately on each Backup Domain Controller (BDC) in the domain. To get an accurate value, each BDC in the domain must be queried, and the largest value is used.

usri3_num_logons

Counts the number of successful times the user tried to log on to this account. A value of 0xFFFFFFFF indicates that the value is unknown. This member is ignored in NetUserAdd and NetUserSetInfo calls. This member is maintained separately on each Backup Domain Controller (BDC) in the domain. To get an accurate value, each BDC in the domain must be queried, and the largest value is used.

usri3_logon_server

Points to a Unicode string that contains the name of the server to which logon requests are sent. Servernames should be preceded by two backslashes (\\). A servername of an asterisk (\\*) indicates that the logon request can be handled by any logon server. A null string indicates that requests are sent to the domain controller. For Windows NT Servers, NetUserGetInfo and NetUserEnum return \\*. The NetUserAdd and NetUserSetInfo functions ignore this member.

usri3_country_code

Specifies the country code for the user's language of choice.

usri3_code_page

Specifies the code page for the user's language of choice.

usri3_user_id

Specifies the relative ID (RID) of the user. The RID is determined by the SAM when the user is created. It uniquely defines this user account to SAM within the domain. The NetUserAdd and NetUserSetInfo functions ignore this member.

usri3_primary_group_id

Specifies the relative ID (RID) of the Primary Global Group for this user. For NetUserAdd, this member must be DOMAIN_GROUP_RID_USERS (defined in NTSEAPI.H). For NetUserSetInfo, this member must be the RID of a global group in which the user is enrolled.

usri3_profile

Specifies a path to the user's profile. This value can be a null string, a local absolute path, or a UNC path.

usri3_home_dir_drive

Specifies the drive letter assigned to the user's home directory for logon purposes.

usri3_password_expired

Determines whether the password of the user has expired. NetUserGetInfo and NetUserAdd return zero if the password has not expired (and nonzero if it has). For NetUserAdd or NetUserSetInfo, specify nonzero to indicate that the user must change password at next logon. For NetUserSetInfo, specify zero to turn off the message indicating that the user must change password at next logon . Note that you cannot specify zero to negate the expiration of a password that has already expired.



See Also

NetUserAdd, NetUserEnum, NetUserSetInfo


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

USER_INFO_3



Уровень структуры данных 3 - в силе только в серверах Windows NT и не 2.x серверы Менеджера LAN.

typedef struct _USER_INFO_3 { usri3_name LPWSTR;
usri3_password LPWSTR;
usri3_password_age DWORD;
usri3_priv DWORD;
usri3_home_dir LPWSTR;
usri3_comment LPWSTR;
usri3_flags DWORD;
usri3_script_path LPWSTR;
usri3_auth_flags DWORD;
usri3_full_name LPWSTR;
usri3_usr_comment LPWSTR;
usri3_parms LPWSTR;
usri3_workstations LPWSTR;
usri3_last_logon DWORD;
usri3_last_logoff DWORD;
usri3_acct_expires DWORD;
usri3_max_storage DWORD;
usri3_units_per_week DWORD;
usri3_logon_hours PBYTE;
usri3_bad_pw_count DWORD;
usri3_num_logons DWORD;
usri3_logon_server LPWSTR;
usri3_country_code DWORD;
usri3_code_page DWORD;
usri3_user_id DWORD;
usri3_primary_group_id DWORD;
usri3_profile LPWSTR;
usri3_home_dir_drive LPWSTR;
usri3_password_expired DWORD;
}USER_INFO_3, *PUSER_INFO_3, *LPUSER_INFO_3;



Участники

usri3_name

Определяет имя счета пользователя. Для NetUserSetInfo, этот элемент проигнорирован. Количество символов в имени не может превысить величину UNLEN.

usri3_password

Пароль для пользователя определялся в usri3_name элементе. Длина не может превысить байты PWLEN. NetUserEnum И возврат функций NetUserGetInfo НЕДЕЙСТВИТЕЛЬНЫЙ указатель, чтобы поддерживать безопасность пароля. Соглашением, Windows NT ограничивает длину паролей в символы LM20_PWLEN. Это соглашение допускает LAN Менеджера, Windows 3.x, Windows для Workgroups 3.x, и клиентов Windows 95, чтобы иметь доступ к серверу Windows NT, использовавшему счет.

usri3_password_age

Определяет время в секундах пройденное с тех пор как usri3_password элемент последний раз был измениться. NetUserAdd И функции NetUserSetInfo игнорируют этот элемент.

usri3_priv

Одна из трех величин, чтобы определять уровень привилегии назначившей usri3_name элемент. NetUserAdd И функции NetUserSetInfo игнорируют этот элемент. Этот элемент может быть одним из следующего величин:

Оцените Значение Администратора USER_PRIV_GUEST Guest USER_PRIV_USER User USER_PRIV_ADMIN


usri3_home_dir

Точки на строку Уникода, содержащие путь домашнего директория пользователя определялись в user_name. Строка может быть недействительна.

usri3_comment

Точки на строку Уникода, что содержит комментарий. Строка может быть недействительной строкой, или это может имело любое количество символов перед завершающим недействительным символом.

usri3_flags

Содержит величины, которые определяют несколько характеристик. Этот элемент может быть любым из следующего величин:

Значение Величины
UF_SCRIPT сценарий ввода выполнялся. Эта величина должна быть установлена для LAN Менеджера 2.0 или Windows NT.
UF_ACCOUNTDISABLE счет пользователя выведен из строя.
UF_HOMEDIR_REQUIRED домашний директорий потребовался. Эта величина проигнорирована в Windows NT.
No пароль UF_PASSWRD_NOTREQD потребовался.
UF_PASSWRD_CANT_CHANGE пользователь не может изменить пароль.
UF_LOCKOUT счет к настоящему времени заблокирован. Для NetUserSetInfo, эта величина может быть очищена, чтобы деблокировать прежде закрытый счет. Эта величина не может быть использована, чтобы запирать прежде деблокировать счет.
UF_DONT_EXPIRE_PASSWORD Представляет пароль, который не должен никогда истекать на счете. Эта величина - в силе только для Windows NT.


Следующее величин описывает учетный тип. Только один величина может быть установлена. Вы не можете изменить учетный тип, использовавший функцию NetUserSetInfo.

Значение Величины
UF_NORMAL_ACCOUNT Это - по умолчанию учетный тип, который представляет типичного пользователя.
UF_TEMP_DUPLICATE_ACCOUNT Это - принимать во внимание пользователей, чей первичный счет - в другой области. Этот счет обеспечивает доступ пользователя к этой области, но не в любую область, которая верит этой области. Менеджер Пользователя имеет отношение к этому учетному типу как локальный счет пользователя.
UF_WORKSTATION_TRUST_ACCOUNT Это - компьютер принимает во внимание Рабочую станцию Windows NT или Сервер Windows NT, которые - элемент этой области.
UF_SERVER_TRUST_ACCOUNT Это - компьютер принимает во внимание Резервного Доменного Диспетчера Windows NT, который - элемент этой области.
UF_INTERDOMAIN_TRUST_ACCOUNT Это - разрешение, чтобы доверие принимает во внимание область Windows NT, которая верит другим областям.


usri3_script_path

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

usri3_auth_flags

Определяет без знака длинное целое, которое содержит величины, которые определяют привилегии оператора пользователя.

Windows NT: Для серверов Windows NT, NetUserAdd и функции NetUserSetInfo игнорируют этот элемент.

Для NetUserGetInfo или NetUserEnum, подходящая величина возвращана основанное в локальном групповом членстве. Если пользователь является элементом Операций Распечатки, AF_OP_PRINT установлен. Если пользователь является элементом Операций Сервера, AF_OP_SERVER установлен. Если пользователь является элементом Операций Счета, AF_OP_ACCOUNTS установлен. AF_OP_COMM никогда не установлен.
NetUserAdd И функции NetUserSetInfo игнорируют этот элемент.
Этот элемент может быть одним из следующего величин:

Значение Величины
AF_OP_PRINT привилегия оператора распечатки приспособлена.
AF_OP_COMM привилегия оператора связи приспособлена.
AF_OP_SERVER привилегия оператора сервера приспособлена.
AF_OP_ACCOUNTS привилегия оператора отчетностей приспособлена.


usri3_full_name

Точки на строку Уникода, что содержит полное имя пользователя. Эта строка может быть недействительной строкой, или это может имело любое количество символов перед завершающим недействительным символом.

usri3_usr_comment

Точки на строку Уникода, что содержит комментарий пользователя. Эта строка может быть недействительной строкой, или это может имело любое количество символов перед завершающим недействительным символом.

usri3_parms

Точки на строку Уникода, что отклонен для использования приложениями. Эта строка может быть недействительной строкой, или это может имело любое количество символов перед завершающим недействительным символом. Продукты Микрософт используют этот элемент, чтобы загружать информацию конфигурации пользователя. Не модифицируйте эту информацию.

usri3_workstations

Точки на строку Уникода, что содержит имена рабочих станций из на которых пользователь может зарегистрироваться. До восьми рабочих станций может быть определено; имена должны быть разделены запятыми (,). Если Вы не хотите ограничить количество рабочих станций, используйте недействительную строку. Для того, чтобы выводить из строя вводы со всех рабочих станций за этот счет, установите величину UF_ACCOUNTDISABLE в usri*_flags элементе.

usri3_last_logon

Определяется когда последний ввод происходил. Эта величина загружена как время в секундах проходило с 00:00:00, 1 Январь, 1970. Этот элемент проигнорирован на NetUserAdd и вызовах NetUserSetInfo. Этот элемент поддерживается отдельно на каждом Резервном Доменном Диспетчере (BDC) в области. Для того, чтобы получать точную величину, каждый BDC в области должно быть спрошено, и самая большая величина использована.

usri3_last_logoff

Определяется когда последний конец сеанса происходил. Эта величина загружена как время в секундах проходило с 00:00:00, 1 Январь, 1970. Величина нуля означает, что последний конец сеанса времени неизвестный. Этот элемент поддерживается отдельно на каждом Резервном Доменном Диспетчере (BDC) в области. Для того, чтобы получать точную величину, каждый BDC в области должно быть спрошено, и самая большая величина использована.

usri3_acct_expires

Определяется когда счет истечет. Эта величина загружена как время в секундах проходило с 00:00:00, 1 Январь, 1970. Величина TIMEQ_FOREVER указывает, что счет никогда не истекает.

usri3_max_storage

Определяет максимальную сумму дискового пространства, что пользователь может использовать. Используйте величину определенную в USER_MAXSTORAGE_UNLIMITED, чтобы использовать все доступное дисковое пространство.

usri3_units_per_week

Определяет число устройств равной длины времени в которое неделя поделена для того, чтобы вычислять длину битовой строки в usri3_logon_hours. Эта величина должна быть UNITS_PER_WEEK для LAN Менеджера 2.0. Этот элемент проигнорирован на NetUserAdd и вызовах NetUserSetInfo. Для услуг Windows NT, устройства должны быть одно из следующего: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK, или SAM_MINUTES_PER_WEEK.

usri3_logon_hours

Точки на 21- байт (168 битов) битовая строка, что определяет время в течение на котором пользователь может зарегистрироваться. Каждый бит представляет уникальный час в течение недели. Первый бит (укусите 0, слово 0), - Воскресенье, 0:00 на 0:59; второй бит (укусите 1, слово 0), - Воскресенье, 1:00 на 1:59; и так далее. Недействительный указатель в этом элементе для NetUserAdd называет средства нет ограничения времени. Недействительный указатель в этом элементе для вызовов NetUserSetInfo означает, что никакое изменение не должно быть сделано.



Бит Примечания 0 в слове 0 представляется В воскресенье с 0:00 на 0:59 только если Вы - в часовом поясе ПО ГРИНВ.. Во всех других случаях, которые Вы должны отрегулировать биты согласно вашему смещению часового пояса (например, ПО ГРИНВ. минус 8 часов для PST).



usri3_bad_pw_count

Определяет раз (а) пользователь попытавшийся, чтобы регистрироваться в счете, использовавшем неправильный пароль. Величина 0xFFFFFFFF указывает, что величина неизвестная. Этот элемент проигнорирован на NetUserAdd и вызовах NetUserSetInfo. Этот элемент поддерживается отдельно на каждом Резервном Доменном Диспетчере (BDC) в области. Для того, чтобы получать точную величину, каждый BDC в области должно быть спрошено, и самая большая величина использована.

usri3_num_logons

Считает номеру успешного времени пользователем попытавшимся, чтобы регистрироваться в этом счете. Величина 0xFFFFFFFF указывает, что величина неизвестная. Этот элемент проигнорирован на NetUserAdd и вызовах NetUserSetInfo. Этот элемент поддерживается отдельно на каждом Резервном Доменном Диспетчере (BDC) в области. Для того, чтобы получать точную величину, каждый BDC в области должно быть спрошено, и самая большая величина использована.

usri3_logon_server

Точки на строку Уникода, что содержит имя сервера на который водит запросы посланы. Servernames Должен быть следован за двумя обратными косыми чертами (\\). servername Звездочки (\\*), указывает, что запрос ввода может быть прооперирован любым сервером ввода. Недействительная строка указывает, что запросы посланы доменному диспетчеру. Для Серверов Windows NT, NetUserGetInfo и возврат \ NetUserEnum\*. NetUserAdd И функции NetUserSetInfo игнорируют этот элемент.

usri3_country_code

Определяет код страны для языка пользователя выбора.

usri3_code_page

Определяет кодовую страницу для языка пользователя выбора.

usri3_user_id

Определяет относительный ID (ОСВОБОДИТЕ) пользователя. RID определен СЭМ когда пользователь создан. Это однозначно определяет этот счет пользователя СЭМ в пределах области. NetUserAdd И функции NetUserSetInfo игнорируют этот элемент.

usri3_primary_group_id

Определяет относительный ID (ОСВОБОДИТЕ) Первичной Глобальной Группы для этого пользователя. Для NetUserAdd, этот элемент должен быть DOMAIN_GROUP_RID_USERS (определенное в NTSEAPI.H). Для NetUserSetInfo, этот элемент должен быть RID глобальный группа в котором пользователь зачислен.

usri3_profile

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

usri3_home_dir_drive

Определяет письмо накопителя назначенное в домашний директорий пользователя для целей ввода.

usri3_password_expired

Определяет истек пароль пользователя. NetUserGetInfo И обратный нуль NetUserAdd если пароль не истек бы (и ненулевой если это имеет). Для NetUserAdd или NetUserSetInfo, определите ненулевой, чтобы указывать, что пользователь должен изменить пароль на следующем вводе. Для NetUserSetInfo, определите нуль, чтобы выключать сообщение, указывающее, что пользователь должен изменить пароль на следующем вводе. Отметьте, что Вы не можете определить нуль, чтобы отрицать истечение срока пароля, которое уже истекло.



Смотри Также

NetUserAdd, NetUserEnum, NetUserSetInfo


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