структура USER_INFO_11 (lmaccess.h)
Структура USER_INFO_11 содержит сведения об учетной записи пользователя, включая имя учетной записи, уровень привилегий, путь к домашнему каталогу пользователя и другие статистические данные о сети, связанные с пользователем.
Синтаксис
typedef struct _USER_INFO_11 {
LPWSTR usri11_name;
LPWSTR usri11_comment;
LPWSTR usri11_usr_comment;
LPWSTR usri11_full_name;
DWORD usri11_priv;
DWORD usri11_auth_flags;
DWORD usri11_password_age;
LPWSTR usri11_home_dir;
LPWSTR usri11_parms;
DWORD usri11_last_logon;
DWORD usri11_last_logoff;
DWORD usri11_bad_pw_count;
DWORD usri11_num_logons;
LPWSTR usri11_logon_server;
DWORD usri11_country_code;
LPWSTR usri11_workstations;
DWORD usri11_max_storage;
DWORD usri11_units_per_week;
PBYTE usri11_logon_hours;
DWORD usri11_code_page;
} USER_INFO_11, *PUSER_INFO_11, *LPUSER_INFO_11;
Члены
usri11_name
Тип: LPWSTR
Указатель на символ Юникода, указывающий имя учетной записи пользователя. Вызовы функции NetUserSetInfo игнорируют этот элемент. Дополнительные сведения см. в разделе "Примечания".
usri11_comment
Тип: LPWSTR
Указатель на строку Юникода, содержащую комментарий, связанный с учетной записью пользователя. Эта строка может быть строкой NULL или иметь любое количество символов до завершающего символа NULL.
usri11_usr_comment
Тип: LPWSTR
Указатель на строку Юникода, содержащую комментарий пользователя. Эта строка может быть строкой NULL или иметь любое количество символов до завершающего символа NULL.
usri11_full_name
Тип: LPWSTR
Указатель на строку Юникода, содержащую полное имя пользователя. Эта строка может быть строкой NULL или иметь любое количество символов до завершающего символа NULL.
usri11_priv
Тип: DWORD
Уровень привилегий, назначенных члену usri11_name . Для вызовов функции NetUserAdd этот элемент должен быть USER_PRIV_USER. Для вызовов NetUserSetInfo этим элементом должно быть значение, возвращаемое функцией NetUserGetInfo или Функцией NetUserEnum . Этот элемент может быть одним из следующих значений. Дополнительные сведения о правах учетных записей пользователей и групп см. в разделе Привилегии.
| Значение | Значение |
|---|---|
|
Гость |
|
Пользователь |
|
Администратор |
usri11_auth_flags
Тип: DWORD
Набор битовых флагов, определяющих привилегии оператора пользователя.
Вызовы функций NetUserGetInfo и NetUserEnum возвращают значение, основанное на членстве пользователя в локальной группе. Если пользователь является членом операторов печати, устанавливается AF_OP_PRINT. Если пользователь является членом операторов сервера, AF_OP_SERVER устанавливается. Если пользователь является членом операторов учетных записей, AF_OP_ACCOUNTS устанавливается. AF_OP_COMM никогда не устанавливается.
Функции NetUserAdd и NetUserSetInfo игнорируют этот элемент.
Применяются следующие ограничения:
- При вызове функции NetUserAdd этот элемент должен быть равен нулю.
- При вызове функции NetUserSetInfo этот член должен быть значением, возвращенным при вызове NetUserGetInfo или NetUserEnum.
usri11_password_age
Тип: DWORD
Количество секунд, прошедшее с момента последнего изменения элемента usri11_password . Функции NetUserAdd и NetUserSetInfo игнорируют этот элемент.
usri11_home_dir
Тип: LPWSTR
Указатель на строку Юникода, указывающую путь к домашнему каталогу для пользователя, указанного в элементе usri11_name . Строка может иметь значение NULL.
usri11_parms
Тип: LPWSTR
Указатель на строку Юникода, зарезервированную для использования приложениями. Эта строка может быть строкой NULL или иметь любое количество символов до завершающего символа NULL. Продукты Майкрософт используют этот элемент для хранения сведений о конфигурации пользователей. Не изменяйте эти сведения.
usri11_last_logon
Тип: DWORD
Дата и время последнего входа в систему. Это значение хранится в виде количества секунд, прошедших с 00:00:00, 1 января 1970 г., GMT. Функции NetUserAdd и NetUserSetInfo игнорируют этот элемент.
Этот член поддерживается отдельно на каждом резервном контроллере домена (BDC) в домене. Чтобы получить точное значение, необходимо запросить каждый BDC в домене. Последний вход произошел в момент, указанный наибольшим извлеченным значением.
usri11_last_logoff
Тип: DWORD
Этот элемент в настоящее время не используется.
Дата и время последнего выхода из системы. Это значение хранится в виде количества секунд, прошедших с 00:00:00, 1 января 1970 г., GMT. Нулевое значение указывает, что время последнего выхода неизвестно. Функции NetUserAdd и NetUserSetInfo игнорируют этот элемент.
Этот член поддерживается отдельно на каждом резервном контроллере домена (BDC) в домене. Чтобы получить точное значение, необходимо запросить каждый BDC в домене. Последний выход произошел в момент, указанный наибольшим извлеченным значением.
usri11_bad_pw_count
Тип: DWORD
Количество попыток входа пользователя в эту учетную запись с неправильным паролем. Значение – 1 указывает, что значение неизвестно. Функции NetUserAdd и NetUserSetInfo игнорируют этот элемент.
Этот элемент реплицируется из основного контроллера домена (PDC); Он также поддерживается на каждом резервном контроллере домена (BDC) в домене. Чтобы получить точное значение, необходимо запросить каждый BDC в домене. Наибольшее полученное значение — количество попыток входа пользователя с неправильным паролем.
usri11_num_logons
Тип: DWORD
Количество успешных попыток входа пользователя в эту учетную запись. Значение – 1 указывает, что значение неизвестно. Вызовы функций NetUserAdd и NetUserSetInfo игнорируют этот элемент.
Этот член поддерживается отдельно на каждом резервном контроллере домена (BDC) в домене. Чтобы получить точное значение, необходимо запросить каждый BDC в домене. Количество успешных попыток входа пользователя — это сумма полученных значений.
usri11_logon_server
Тип: LPWSTR
Указатель на строку Юникода, содержащую имя сервера, на который отправляются запросы на вход. Имена серверов должны предшествовать двумя обратными косыми чертами (\). Чтобы указать, что запрос на вход может быть обработан любым сервером входа, укажите звездочку (\*) для имени сервера. Строка NULL указывает, что запросы должны отправляться на контроллер домена.
Для серверов Windows NetUserGetInfo и NetUserEnum возвращают \*. Функции NetUserAdd и NetUserSetInfo игнорируют этот элемент.
usri11_country_code
Тип: DWORD
Код страны или региона для выбранного пользователем языка.
usri11_workstations
Тип: LPWSTR
Указатель на строку Юникода, содержащую имена рабочих станций, с которых пользователь может войти в систему. Можно указать до восьми рабочих станций; имена должны быть разделены запятыми. Строка NULL указывает, что ограничений нет. Чтобы отключить вход в эту учетную запись со всех рабочих станций, задайте значение UF_ACCOUNTDISABLE в элементе usri11_flags .
usri11_max_storage
Тип: DWORD
Максимальный объем дискового пространства, который может использовать пользователь. Укажите USER_MAXSTORAGE_UNLIMITED, чтобы использовать все доступное место на диске.
usri11_units_per_week
Тип: DWORD
Количество единиц времени равной длины, на которые делится неделя. Это значение требуется для вычисления длины битовой строки в элементе usri11_logon_hours .
Этот элемент должен быть UNITS_PER_WEEK для LAN Manager 2.0. Этот элемент игнорируется функциями NetUserAdd и NetUserSetInfo .
Для приложений-служб единицы должны иметь одно из следующих значений: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK или SAM_MINUTES_PER_WEEK.
usri11_logon_hours
Тип: PBYTE
Указатель на 21-байтовую (168 бит) битовую строку, указывающую время, в течение которого пользователь может войти в систему. Каждый бит представляет уникальный час недели в среднем по Гринвичу (GMT).
Первый бит (бит 0, слово 0) — воскресенье, с 0:00 до 0:59; второй бит (бит 1, слово 0) — воскресенье, с 1:00 до 1:59; и так далее. Обратите внимание, что бит 0 в слове 0 представляет воскресенье с 0:00 до 0:59, только если вы находитесь в часовом поясе GMT. Во всех остальных случаях необходимо настроить биты в соответствии со смещением часового пояса (например, GMT минус 8 часов для тихоокеанского стандартного времени).
Укажите указатель NULL в этом элементе при вызове функции NetUserAdd , чтобы указать отсутствие ограничений по времени. Укажите указатель NULL при вызове функции NetUserSetInfo , чтобы указать, что время, в течение которого пользователь может войти в систему, не нужно вносить никаких изменений.
usri11_code_page
Тип: DWORD
Кодовая страница для выбранного пользователем языка.
Комментарии
Имена учетных записей пользователей ограничены 20 символами, а имена групп — 256 символами. Кроме того, имена учетных записей не могут быть завершены точкой и не могут содержать запятые или какие-либо из следующих печатных символов: ", /, , [, ], :, |, <, >, +, =, ;, ?, *. Имена также не могут содержать символы в диапазоне от 1 до 31, которые не могут быть печатными.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | lmaccess.h (включая Lm.h) |