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 関数から返される値である必要があります。 このメンバーには、次のいずれかの値を指定できます。 ユーザーとグループのアカウント権限の詳細については、「 特権」を参照してください。

usri11_auth_flags

型: DWORD

ユーザーのオペレーター特権を定義するビット フラグのセット。

NetUserGetInfo 関数と NetUserEnum 関数の呼び出しは、ユーザーのローカル グループ メンバーシップに基づいて値を返します。 ユーザーが Print Operators のメンバーである場合は、AF_OP_PRINTが設定されます。 ユーザーがサーバーオペレーターのメンバーである場合は、AF_OP_SERVERが設定されます。 ユーザーが Account Operators のメンバーである場合は、AF_OP_ACCOUNTSが設定されます。 AF_OP_COMMは設定されません。

NetUserAdd 関数と NetUserSetInfo 関数は、このメンバーを無視します。

次の制限事項が適用されます。

• NetUserAdd 関数を呼び出す場合、このメンバーは 0 である必要があります。
• NetUserSetInfo 関数を呼び出す場合、このメンバーは、NetUserGetInfo または NetUserEnum の呼び出しから返される値である必要があります。

usri11_password_age

型: DWORD

usri11_password メンバーが最後に変更されてから経過した秒数。 NetUserAdd 関数と NetUserSetInfo 関数は、このメンバーを無視します。

usri11_home_dir

種類: LPWSTR

usri11_name メンバーで指定されたユーザーのホーム ディレクトリのパスを指定する Unicode 文字列へのポインター。 文字列には NULL を指定できます。

usri11_parms

種類: LPWSTR

アプリケーションで使用するために予約されている Unicode 文字列へのポインター。 この文字列には NULL 文字列を指定することも、終端の null 文字の前に任意の数の文字を指定することもできます。 Microsoft 製品では、このメンバーを使用してユーザー構成情報を格納します。 この情報は変更しないでください。

usri11_last_logon

型: DWORD

最後のログオンが発生した日時。 この値は、GMT 1970 年 1 月 1 日の 00:00:00 から経過した秒数として格納されます。 NetUserAdd 関数と NetUserSetInfo 関数は、このメンバーを無視します。

このメンバーは、ドメイン内の各バックアップ ドメイン コントローラー (BDC) で個別に管理されます。 正確な値を取得するには、ドメイン内の各 BDC に対してクエリを実行する必要があります。 最後のログオンは、取得された最大の値で示された時点で発生しました。

usri11_last_logoff

型: DWORD

このメンバーは現在使用されていません。

最後のログオフが発生した日時。 この値は、GMT 1970 年 1 月 1 日の 00:00:00 から経過した秒数として格納されます。 値 0 は、最後のログオフ時刻が不明であることを示します。 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 文字列へのポインター。 サーバー名の前に 2 つの円記号 (\) を付ける必要があります。 ログオン要求を任意のログオン サーバーで処理できることを示すには、サーバー名にアスタリスク (\*) を指定します。 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 です。2 番目のビット (ビット 1、単語 0) は日曜日の 1:00 から 1:59 です。などなど。 単語 0 のビット 0 は、GMT タイム ゾーンにいる場合にのみ、日曜日の 0:00 から 0:59 を表します。 それ以外の場合は、タイム ゾーン オフセットに従ってビットを調整する必要があります (たとえば、太平洋標準時の GMT から 8 時間を引いた場合)。

時間制限がないことを示すために NetUserAdd 関数を呼び出すときに、このメンバーに NULL ポインターを指定します。 NetUserSetInfo 関数を呼び出すときに NULL ポインターを指定して、ユーザーがログオンできる時間に変更を加えないことを示します。

usri11_code_page

型: DWORD

ユーザーが選択した言語のコード ページ。

注釈

ユーザー アカウント名は 20 文字に制限され、グループ名は 256 文字に制限されます。 さらに、アカウント名をピリオドで終えることはできません。また、コンマまたは"、/、、[、]、:、|<>、+、=、;、?、*のいずれかの印刷可能な文字を含めることはできません。 名前には、印刷できない 1 から 31 の範囲の文字を含めることもできます。

要件

こちらもご覧ください

NetUserAdd

NetUserDel

NetUserEnum

NetUserGetInfo

NetUserSetInfo

ネットワーク管理の概要

ネットワーク管理構造

ユーザー関数