共用方式為


USER_INFO_22 結構 (lmaccess.h)

USER_INFO_22結構包含使用者帳戶的相關資訊,包括帳戶名稱、許可權等級、使用者主目錄的路徑、單向加密 LAN Manager 2。x相容的密碼,以及其他與使用者相關的網路統計資料。

語法

typedef struct _USER_INFO_22 {
  LPWSTR usri22_name;
  BYTE   usri22_password[ENCRYPTED_PWLEN];
  DWORD  usri22_password_age;
  DWORD  usri22_priv;
  LPWSTR usri22_home_dir;
  LPWSTR usri22_comment;
  DWORD  usri22_flags;
  LPWSTR usri22_script_path;
  DWORD  usri22_auth_flags;
  LPWSTR usri22_full_name;
  LPWSTR usri22_usr_comment;
  LPWSTR usri22_parms;
  LPWSTR usri22_workstations;
  DWORD  usri22_last_logon;
  DWORD  usri22_last_logoff;
  DWORD  usri22_acct_expires;
  DWORD  usri22_max_storage;
  DWORD  usri22_units_per_week;
  PBYTE  usri22_logon_hours;
  DWORD  usri22_bad_pw_count;
  DWORD  usri22_num_logons;
  LPWSTR usri22_logon_server;
  DWORD  usri22_country_code;
  DWORD  usri22_code_page;
} USER_INFO_22, *PUSER_INFO_22, *LPUSER_INFO_22;

成員

usri22_name

類型: LPWSTR

指定使用者帳戶名稱的 Unicode 字串指標。 對 NetUserSetInfo函式的呼叫會忽略此成員。 如需詳細資訊,請參閱接下來的<備註>一節。

usri22_password[ENCRYPTED_PWLEN]

類型: BYTE[ENCRYPTED_PWLEN]

單向加密 LAN Manager 2。x相容密碼。

usri22_password_age

類型: DWORD

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

usri22_priv

類型: DWORD

指派給 usri22_name 成員的許可權層級。 對 NetUserAdd函式的呼叫必須指定USER_PRIV_USER。 當您呼叫 NetUserSetInfo 函式時,這個成員必須是從 NetUserGetInfoNetUserEnum 函式傳回的值。 這個成員可以是下列其中一個值。 如需使用者和群組帳戶許可權的詳細資訊,請參閱 許可權

意義
USER_PRIV_GUEST
來賓
USER_PRIV_USER
使用者
USER_PRIV_ADMIN
系統管理員

usri22_home_dir

類型: LPWSTR

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

usri22_comment

類型: LPWSTR

Unicode 字串的指標,其中包含與使用者帳戶相關聯的批註。 此字串可以是 Null 字串,或者它可以在終止 Null 字元之前具有任意數目的字元。

usri22_flags

類型: DWORD

這個成員可以是下列一或多個值。

請注意,設定使用者帳戶控制旗標可能需要特定 許可權 和控制 存取權限。 如需詳細資訊,請參閱 NetUserSetInfo 函式的一節。

意義
UF_SCRIPT
執行的登入腳本。 必須設定此值。
UF_ACCOUNTDISABLE
使用者帳戶已停用。
UF_HOMEDIR_REQUIRED
需要主目錄。 這個值會被忽略。
UF_PASSWD_NOTREQD
不需要密碼。
UF_PASSWD_CANT_CHANGE
使用者無法變更密碼。
UF_LOCKOUT
帳戶目前已鎖定。您可以呼叫 NetUserSetInfo 函式來清除此值,並解除鎖定先前鎖定的帳戶。 您無法使用此值來鎖定先前解除鎖定的帳戶。
UF_DONT_EXPIRE_PASSWD
密碼應該永遠不會在帳戶上過期。
UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED
使用者的密碼會儲存在 Active Directory 中可反轉加密之下。
UF_NOT_DELEGATED
將帳戶標示為「敏感性」;其他使用者無法作為此使用者帳戶的委派。
UF_SMARTCARD_REQUIRED
需要使用者以智慧卡登入使用者帳戶。
UF_USE_DES_KEY_ONLY
限制此主體只使用金鑰的資料加密標準 (DES) 加密類型。
UF_DONT_REQUIRE_PREAUTH
此帳戶不需要 Kerberos 預先驗證進行登入。
UF_TRUSTED_FOR_DELEGATION
帳戶已啟用委派。 這是安全性敏感性設定;啟用此選項的帳戶應該受到嚴格控制。 此設定可讓帳戶下執行的服務假設用戶端的身分識別,並以該使用者身分向網路上的其他遠端伺服器進行驗證。
UF_PASSWORD_EXPIRED
使用者的密碼已過期。

Windows 2000: 不支援這個值。

UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION
此帳戶受信任,可驗證 Kerberos 安全性套件外部的使用者,並透過限制委派該使用者。 這是安全性敏感性設定;啟用此選項的帳戶應該受到嚴格控制。 此設定可讓帳戶下執行的服務判斷提示用戶端的身分識別,並以該使用者身分驗證網路上特別設定的服務。

Windows XP/2000: 不支援這個值。

 

下列值描述帳戶類型。 只能設定一個值。 您無法使用 NetUserSetInfo 函式來變更帳戶類型。

意義
UF_NORMAL_ACCOUNT
這是代表一般使用者的預設帳戶類型。
UF_TEMP_DUPLICATE_ACCOUNT
這是主要帳戶位於另一個網域的使用者帳戶。 此帳戶可讓使用者存取此網域,但不會提供信任此網域的任何網域。 使用者管理員會將此帳戶類型稱為本機使用者帳戶。
UF_WORKSTATION_TRUST_ACCOUNT
這是屬於此網域成員之電腦的電腦帳戶。
UF_SERVER_TRUST_ACCOUNT
這是屬於此網域成員之備份網域控制站的電腦帳戶。
UF_INTERDOMAIN_TRUST_ACCOUNT
這是允許信任其他網域之網域的信任帳戶。

usri22_script_path

類型: LPWSTR

Unicode 字串的指標,指定使用者登入腳本檔案的路徑。 腳本檔案可以是 。CMD 檔案、.EXE 檔案或 .BAT 檔案。 字串也可以是 Null。

usri22_auth_flags

類型: DWORD

使用者的操作員許可權。

呼叫 NetUserGetInfo 函式,而 NetUserEnum 函式會根據使用者的本機群組成員資格傳回值。 如果使用者是列印運算子的成員,則會設定AF_OP_PRINT。 如果使用者是伺服器操作員的成員,則會設定 AF_OP_SERVER。 如果使用者是帳戶操作員的成員,則會設定AF_OP_ACCOUNTS。 永遠不會設定AF_OP_COMM。

適用以下限制:

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

usri22_full_name

類型: LPWSTR

Unicode 字串的指標,其中包含使用者的完整名稱。 此字串可以是 Null 字串,或者它可以在終止 Null 字元之前具有任意數目的字元。

usri22_usr_comment

類型: LPWSTR

包含使用者批註之 Unicode 字串的指標。 此字串可以是 Null 字串,或者它可以在終止 Null 字元之前具有任意數目的字元。

usri22_parms

類型: LPWSTR

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

usri22_workstations

類型: LPWSTR

重要

您不應該再使用 usri22_workstations。 相反地,您可以設定 [使用者權限指派] 設定 ([允許在本機 登入] 和 [ 拒絕本機登入],或 [允許透過遠端桌面服務 登入] 和 [ 拒絕透過遠端桌面服務登入 ]) ,來控制工作站的登入存取。

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

usri22_last_logon

類型: DWORD

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

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

usri22_last_logoff

類型: DWORD

目前未使用這個成員。

上次登出的日期和時間。 此值會儲存為自 00:00:00:00、1970 年 1 月 1 日起經過的秒數。 值為零表示最後一次登出時間未知。 呼叫 NetUserAddNetUserSetInfo會忽略此元素。

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

usri22_acct_expires

類型: DWORD

帳戶到期的日期和時間。 此值會儲存為自 00:00:00:00、1970 年 1 月 1 日起經過的秒數。 TIMEQ_FOREVER值表示帳戶永遠不會過期。

usri22_max_storage

類型: DWORD

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

usri22_units_per_week

類型: DWORD

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

區域網路管理員 2.0 必須UNITS_PER_WEEK此值。 呼叫 NetUserAddNetUserSetInfo 函式會忽略此成員。

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

usri22_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 指標,以指出使用者可登入的時間不會進行任何變更。

usri22_bad_pw_count

類型: DWORD

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

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

usri22_num_logons

類型: DWORD

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

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

usri22_logon_server

類型: LPWSTR

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

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

usri22_country_code

類型: DWORD

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

這個值會被忽略。

usri22_code_page

類型: DWORD

使用者所選語言的字碼頁。

這個值會被忽略。

備註

使用者帳戶名稱限制為 20 個字元,且組名限制為 256 個字元。 此外,帳戶名稱不能以句號終止,而且不能包含逗號或任何下列可列印字元:「、/、、、[、]、:、| <> 、?、*。 名稱也無法在範圍 1-31 中包含不可列印的字元。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 lmaccess.h (包括 Lm.h)

另請參閱

NetUserAdd

NetUserEnum

NetUserGetInfo

NetUserSetInfo

網路管理概觀

網路管理結構

使用者函式