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


структура 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 . Этот элемент может быть одним из следующих значений. Дополнительные сведения о правах учетных записей пользователей и групп см. в разделе Привилегии.

Значение Значение
USER_PRIV_GUEST
Гость
USER_PRIV_USER
Пользователь
USER_PRIV_ADMIN
Администратор

usri11_auth_flags

Тип: DWORD

Набор битовых флагов, определяющих привилегии оператора пользователя.

Вызовы функций 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
Права оператора учетных записей включены.

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)

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

NetUserAdd

NetUserDel

NetUserEnum

NetUserGetInfo

NetUserSetInfo

Общие сведения об управлении сетью

Структуры управления сетью

Пользовательские функции