次の方法で共有


LogonUserA 関数 (winbase.h)

LogonUser 関数は、ユーザーをローカル コンピューターにログオンしようとします。 ローカル コンピューターは、LogonUser 呼び出されたコンピューターです。 LogonUser を使用してリモート コンピューターにログオンすることはできません。 ユーザー名とドメインを使用してユーザーを指定し、プレーンテキスト パスワードを使用してユーザー 認証 。 関数が成功した場合は、ログオンしているユーザーを表すトークンへのハンドルを受け取ります。 その後、このトークン ハンドルを使用して、指定したユーザーを偽装したり、ほとんどの場合、指定したユーザーのコンテキストで実行される プロセス を作成したりできます。

構文

BOOL LogonUserA(
  [in]           LPCSTR  lpszUsername,
  [in, optional] LPCSTR  lpszDomain,
  [in, optional] LPCSTR  lpszPassword,
  [in]           DWORD   dwLogonType,
  [in]           DWORD   dwLogonProvider,
  [out]          PHANDLE phToken
);

パラメーター

[in] lpszUsername

ユーザーの名前を指定する null で終わる文字列へのポインター。 これは、ログオンするユーザー アカウントの名前です。 ユーザー プリンシパル名 (UPN) 形式 、ユーザーDNSDomainNameを使用する場合は、lpszDomain パラメーターを NULLする必要があります。

[in, optional] lpszDomain

アカウント データベースに lpszUsername アカウントが含まれているドメインまたはサーバーの名前を指定する null で終わる文字列へのポインター。 このパラメーターが NULL場合は、ユーザー名を UPN 形式で指定する必要があります。 このパラメーターが "." の場合、関数はローカル アカウント データベースのみを使用してアカウントを検証します。

[in, optional] lpszPassword

lpszUsernameで指定されたユーザー アカウントのプレーンテキスト パスワード 指定する null で終わる文字列へのポインター。 パスワードの使用が完了したら、SecureZeroMemory 関数を呼び出して、メモリからパスワードをクリアします。 パスワードの保護の詳細については、「パスワードの処理」を参照してください。

[in] dwLogonType

実行するログオン操作の種類。 このパラメーターには、Winbase.h で定義されている次のいずれかの値を指定できます。

価値 意味
LOGON32_LOGON_BATCH
このログオンの種類は、プロセスがユーザーの代わりに直接介入することなく実行されるバッチ サーバーを対象としています。 この種類は、メールや Web サーバーなど、一度に多数のプレーンテキスト認証試行を処理するパフォーマンスの高いサーバー用でもあります。
LOGON32_LOGON_INTERACTIVE
このログオンの種類は、ターミナル サーバー、リモート シェル、または同様のプロセスによってログオンしているユーザーなど、コンピューターを対話形式で使用するユーザーを対象としています。 このログオンの種類には、切断された操作のログオン情報のキャッシュに追加の費用がかかります。そのため、メール サーバーなどの一部のクライアント/サーバー アプリケーションでは不適切です。
LOGON32_LOGON_NETWORK
このログオンの種類は、ハイ パフォーマンス サーバーがプレーンテキスト パスワードを認証することを目的としています。 LogonUser 関数は、このログオンの種類の資格情報をキャッシュしません。
LOGON32_LOGON_NETWORK_CLEARTEXT
このログオンの種類では、認証パッケージ内の名前とパスワードが保持されます。これにより、サーバーはクライアントの偽装中に他のネットワーク サーバーに接続できます。 サーバーは、クライアントからプレーンテキストの資格情報を受け入れ、LogonUser呼び出し、ユーザーがネットワーク経由でシステムにアクセスできることを確認し、他のサーバーと通信できます。
LOGON32_LOGON_NEW_CREDENTIALS
このログオンの種類により、呼び出し元は現在のトークンを複製し、送信接続の新しい資格情報を指定できます。 新しいログオン セッションは同じローカル識別子を持ちますが、他のネットワーク接続には異なる資格情報を使用します。

このログオンの種類は、LOGON32_PROVIDER_WINNT50 ログオン プロバイダーでのみサポートされます。

注: 2023 年 1 月の時点で、グループ管理サービス アカウント (gMSA) でLOGON32_LOGON_NEW_CREDENTIALS ログオンの種類を使用することはできません。

LOGON32_LOGON_SERVICE
サービスの種類のログオンを示します。 指定されたアカウントでサービス特権が有効になっている必要があります。
LOGON32_LOGON_UNLOCK
GINA はサポートされなくなりました。

Windows Server 2003 および Windows XP: このログオンの種類は、コンピューターを対話形式で使用するユーザーにログオンする GINA DLL 用です。 このログオンの種類では、ワークステーションのロックが解除された日時を示す一意の監査レコードを生成できます。

[in] dwLogonProvider

ログオン プロバイダーを指定します。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
LOGON32_PROVIDER_DEFAULT
システムの標準ログオン プロバイダーを使用します。 ドメイン名 NULL を渡し、ユーザー名が UPN 形式でない場合を除き、既定の セキュリティ プロバイダー はネゴシエートされます。 この場合、既定のプロバイダーは NTLM です。
LOGON32_PROVIDER_WINNT50
ネゴシエート ログオン プロバイダーを使用します。
LOGON32_PROVIDER_WINNT40
NTLM ログオン プロバイダーを使用します。

[out] phToken

指定したユーザーを表すトークンへのハンドルを受け取るハンドル変数へのポインター。

返されたハンドルは、ImpersonateLoggedOnUser 関数の呼び出しで使用できます。

ほとんどの場合、返されるハンドルは、CreateProcessAsUser 関数の呼び出しで使用できる プライマリ トークン です。 ただし、LOGON32_LOGON_NETWORK フラグを指定した場合、LogonUser は、CreateProcessAsUser で使用できない 偽装トークンDuplicateTokenEx を呼び出してプライマリ トークンに変換しない限り返します。

このハンドルが不要になったら、CloseHandle 関数を呼び出してハンドルを閉じます。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

LOGON32_LOGON_NETWORK ログオンの種類は最速ですが、次の制限があります。

  • この関数は、プライマリ トークンではなく、偽装トークンを返します。 このトークンは、CreateProcessAsUser 関数では直接使用できません。 ただし、DuplicateTokenEx 関数を呼び出してトークンをプライマリ トークンに変換し、それを CreateProcessAsUserで使用できます。
  • トークンをプライマリ トークンに変換し、CreateProcessAsUser で使用してプロセスを開始した場合、新しいプロセスはリダイレクターを介してリモート サーバーやプリンターなどの他のネットワーク リソースにアクセスできません。 例外として、ネットワーク リソースがアクセス制御されていない場合、新しいプロセスでアクセスできるようになります。

Passport アカウントにログオンしている場合を除き、この関数にはSE_TCB_NAME特権は必要ありません。

lpszUsername指定されたアカウントには、必要なアカウント権限が必要です。 たとえば、LOGON32_LOGON_INTERACTIVE フラグを使用してユーザーにログオンするには、ユーザー (またはユーザーが属するグループ) に SE_INTERACTIVE_LOGON_NAME アカウント権限が必要です。 さまざまなログオン操作に影響するアカウント権限の一覧については、「アカウント権限定数の」を参照してください。

少なくとも 1 つのトークンが存在する場合、ユーザーはログオンと見なされます。 CreateProcessAsUser 呼び出してトークンを閉じると、システムは、プロセス (およびすべての子プロセス) が終了するまでユーザーがまだログオンしたと見なします。

LogonUser 呼び出しが成功した場合、システムは、プロバイダーの NPLogonNotify エントリ ポイント関数を呼び出すことによってログオンが発生したことをネットワーク プロバイダーに通知します。

LocalService トークンは、次のコードを使用して生成できます。

LogonUser(L"LocalService", L"NT AUTHORITY", NULL, LOGON32_LOGON_SERVICE, LOGON32_PROVIDER_DEFAULT, &hToken)

手記

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LogonUser を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winbase.h (Windows.h を含む)
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

クライアント/サーバー のアクセス制御の

クライアント/サーバー のアクセス制御関数の

CloseHandle の

CreateProcessAsUser の

DuplicateTokenEx の

ImpersonateLoggedOnUser