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

指定使用者帳戶名稱之 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。

NetUserAddNetUserSetInfo 函式會忽略此成員。

適用以下限制:

這個成員可以是下列一或多個值。
意義
AF_OP_PRINT
已啟用列印操作員許可權。
AF_OP_COMM
通訊操作員許可權已啟用。
AF_OP_SERVER
已啟用伺服器操作員許可權。
AF_OP_ACCOUNTS
已啟用帳戶操作員許可權。

usri11_password_age

類型: DWORD

自上次變更 usri11_password 成員以來經過的秒數。 NetUserAddNetUserSetInfo 函式會忽略此成員。

usri11_home_dir

類型: LPWSTR

Unicode 字串的指標,指定 usri11_name 成員中所指定使用者的主目錄路徑。 字串可以是 NULL

usri11_parms

類型: LPWSTR

保留供應用程式使用的 Unicode 字串指標。 此字串可以是 NULL 字串,或者它可以在終止Null字元之前具有任意數目的字元。 Microsoft 產品會使用此成員來儲存使用者設定資訊。 請勿修改此資訊。

usri11_last_logon

類型: DWORD

上次登入的日期和時間。 此值會儲存為自 00:00:00:00、1970 年 1 月 1 日起經過的秒數。 NetUserAddNetUserSetInfo 函式會忽略此成員。

此成員會在網域中的每個備份域控制器上個別維護 (BDC) 。 若要取得精確的值,您必須查詢網域中的每個 BDC。 上次登入發生在最大擷取值所指示的時間。

usri11_last_logoff

類型: DWORD

目前未使用這個成員。

上次註銷的日期和時間。 此值會儲存為自 00:00:00:00、1970 年 1 月 1 日起經過的秒數。 值為零表示最後一次註銷時間未知。 NetUserAdd 函式和 NetUserSetInfo 函式會忽略此成員。

此成員會在網域中的每個備份域控制器上個別維護 (BDC) 。 若要取得精確的值,您必須查詢網域中的每個 BDC。 上次註銷發生在最大擷取值所指示的時間。

usri11_bad_pw_count

類型: DWORD

用戶嘗試使用不正確的密碼登入此帳戶的次數。 值為 – 1 表示值未知。 NetUserAddNetUserSetInfo 函式會忽略此成員。

此成員會從主要域控制器複寫, (PDC) ;它也會在網域中的每個備份域控制器上維護 (BDC) 。 若要取得精確的值,您必須查詢網域中的每個 BDC。 用戶嘗試使用不正確密碼登入的次數是擷取的最大值。

usri11_num_logons

類型: DWORD

使用者已成功登入此帳戶的次數。 值為 – 1 表示值未知。 呼叫 NetUserAddNetUserSetInfo 函式會忽略此成員。

此成員會在網域中的每個備份域控制器上個別維護 (BDC) 。 若要取得精確的值,您必須查詢網域中的每個 BDC。 使用者成功登入的次數是所擷取值的總和。

usri11_logon_server

類型: LPWSTR

Unicode 字串的指標,其中包含傳送登入要求之伺服器的名稱。 伺服器名稱前面應該有兩個反斜杠 (\) 。 若要指出登入要求可由任何登入伺服器處理,請為伺服器名稱指定星號 (\*) 。 NULL 字串表示要求應該傳送至域控制器。

針對 Windows 伺服器, NetUserGetInfoNetUserEnum 會 傳回 \*。 NetUserAddNetUserSetInfo 函式會忽略此成員。

usri11_country_code

類型: DWORD

用戶所選語言的國家/地區代碼。

usri11_workstations

類型: LPWSTR

Unicode 字串的指標,其中包含用戶可從中登入的工作站名稱。 可以指定多達八個工作站;名稱必須以逗號分隔。 NULL 字串表示沒有任何限制。 若要停用從所有工作站登入此帳戶,請在usri11_flags成員中設定 UF_ACCOUNTDISABLE 值。

usri11_max_storage

類型: DWORD

用戶可以使用的磁碟空間上限。 指定USER_MAXSTORAGE_UNLIMITED以使用所有可用的磁碟空間。

usri11_units_per_week

類型: DWORD

周除以的相等長度時間單位數目。 需要這個值,才能計算 usri11_logon_hours 成員中的位字串長度。

此成員必須UNITS_PER_WEEK LAN Manager 2.0。 NetUserAddNetUserSetInfo 函式會忽略這個專案。

對於服務應用程式,單位必須是下列其中一個值:SAM_DAYS_PER_WEEK、SAM_HOURS_PER_WEEK或SAM_MINUTES_PER_WEEK。

usri11_logon_hours

類型: PBYTE

21 位元組 (168 位) 位字串的指標,指定使用者可以登入的時間。 每一位都代表一周中唯一的小時,以 Greenwich Mean Time (GMT) 。

第一個位 (位 0,單字 0) 是星期日,0:00 到 0:59;第二個位 (位 1,word 0) 是星期日,1:00 到 1:59;依此類故。 請注意,只有在您位於 GMT 時區時,字 0 中的位 0 代表從 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)

另請參閱

NetUserAdd

NetUserDel

NetUserEnum

NetUserGetInfo

NetUserSetInfo

網路管理概觀

網路管理結構

使用者函式