USER_INFO_11 结构 (lmaccess.h)

项目
02/28/2024

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

指向 Unicode 字符的指针，该字符指定用户帐户的名称。对 NetUserSetInfo 函数的调用将忽略此成员。有关更多信息，请参见下面的“备注”部分。

usri11_comment

类型： LPWSTR

指向包含与用户帐户关联的注释的 Unicode 字符串的指针。此字符串可以是 NULL 字符串，也可以在终止 null 字符之前具有任意数量的字符。

usri11_usr_comment

类型： LPWSTR

指向包含用户注释的 Unicode 字符串的指针。此字符串可以是 NULL 字符串，也可以在终止 null 字符之前具有任意数量的字符。

usri11_full_name

类型： LPWSTR

指向包含用户全名的 Unicode 字符串的指针。此字符串可以是 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 函数将忽略此成员。

存在以下限制：

调用 NetUserAdd 函数时，此成员必须为零。
调用 NetUserSetInfo 函数时，此成员必须是从对 NetUserGetInfo 或 NetUserEnum 的调用返回的值。

此成员可以是以下一个或多个值。

值	含义
AF_OP_PRINT	打印操作员权限已启用。
AF_OP_COMM	通信操作员权限已启用。
AF_OP_SERVER	已启用服务器操作员权限。
AF_OP_ACCOUNTS	帐户操作员权限已启用。

usri11_password_age

类型：DWORD

自上次更改 usri11_password 成员以来经过的秒数。 NetUserAdd 和 NetUserSetInfo 函数将忽略此成员。

usri11_home_dir

类型： LPWSTR

指向 Unicode 字符串的指针，该字符串指定 在 usri11_name 成员中指定的用户的主目录的路径。字符串可以为 NULL。

usri11_parms

类型： LPWSTR

指向保留供应用程序使用的 Unicode 字符串的指针。此字符串可以是 NULL 字符串，也可以在终止 null 字符之前具有任意数量的字符。 Microsoft 产品使用此成员来存储用户配置信息。请勿修改此信息。

usri11_last_logon

类型：DWORD

上次登录的日期和时间。此值存储为自 1970 年 1 月 1 日 GMT 00：00：00 以来经过的秒数。 NetUserAdd 和 NetUserSetInfo 函数将忽略此成员。

此成员在每个备份域控制器上单独维护， (域中的 BDC) 。若要获取准确的值，必须查询域中的每个 BDC。上次登录发生在由最大检索值指示的时间。

usri11_last_logoff

类型：DWORD

当前未使用此成员。

上次注销的日期和时间。此值存储为自 1970 年 1 月 1 日 GMT 00：00：00 以来经过的秒数。值为零表示上次注销时间未知。 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

指向 Unicode 字符串的指针，该字符串包含向其发送登录请求的服务器的名称。服务器名称前面应有两个反斜杠 (\) 。若要指示登录请求可由任何登录服务器处理，请为服务器名称指定星号 (\*) 。 NULL 字符串指示应将请求发送到域控制器。

对于 Windows 服务器， NetUserGetInfo 和 NetUserEnum 返回 \*。 NetUserAdd 和 NetUserSetInfo 函数忽略此成员。

usri11_country_code

类型：DWORD

用户所选语言的国家/地区代码。

usri11_workstations

类型： LPWSTR

指向 Unicode 字符串的指针，该字符串包含用户可以从中登录的工作站的名称。可以指定多达 8 个工作站;名称必须用逗号分隔。 NULL 字符串指示没有限制。若要禁用从所有工作站到此帐户的登录，请在 usri11_flags 成员中设置 UF_ACCOUNTDISABLE 值。

usri11_max_storage

类型：DWORD

用户可以使用的最大磁盘空间量。指定USER_MAXSTORAGE_UNLIMITED以使用所有可用磁盘空间。

usri11_units_per_week

类型：DWORD

将周划分为的等长时间单位的数目。此值是计算 usri11_logon_hours 成员中位字符串的长度所必需的。

必须为 LAN Manager 2.0 UNITS_PER_WEEK此成员。 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;等等。请注意，Word 0 中的位 0 仅当处于 GMT 时区时表示星期日从 0：00 到 0：59。在所有其他情况下，必须根据时区偏移量调整位 (例如，太平洋标准时间) GMT 减去 8 小时。

调用 NetUserAdd 函数时，在此成员中指定 NULL 指针，以指示无时间限制。在调用 NetUserSetInfo 函数时指定 NULL 指针，以指示不对用户可以登录的时间进行更改。

usri11_code_page

类型：DWORD

用户所选语言的代码页。

注解

用户帐户名称限制为 20 个字符，组名称限制为 256 个字符。此外，帐户名称不能以句点结尾，并且不能包含逗号或以下任何可打印字符：“、、/、、[、]、：、|、 <、、 >、+、=、;、？、*。名称也不能包含 1-31 范围内的字符，这些字符不可打印。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	lmaccess.h (包括 Lm.h)