IConnectedIdentityProvider::ConnectIdentity メソッド (identityprovider.h)

  • [アーティクル]

ID をドメイン ユーザーに接続します。

構文

HRESULT ConnectIdentity(
  [in] BYTE  *AuthBuffer,
  [in] ULONG AuthBufferSize
);

パラメーター

[in] AuthBuffer

マーシャリングされた認証バッファー SEC_WINNT_AUTH_IDENTITY_EX2 オンライン ID の資格情報を含む構造体。 バッファーは、 credPackAuthenticationBuffer 関数と CRED_PACK_ID_PROVIDER_CREDENTIALS オプションを使用して呼び出し元が構築することも、 CredUIPromptForWindowsCredentials 関数からオンライン ID 資格情報プロバイダーによって返することもできます。 必要に応じて、SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON オプションを使用して SspiEncryptAuthIdentityEx 関数を呼び出すことで、バッファーを暗号化できます。

[in] AuthBufferSize

AuthBuffer パラメーターのサイズ (バイト単位)。

戻り値

メソッドが成功した場合は、S_OKを返します。

メソッドが失敗した場合は、Win32 エラー コードを返します。

リターン コード 説明
S_OK
 メソッドが成功しました。
ERROR_LOGON_FAILURE
 ユーザー名またはパスワードが正しくありません。
ERROR_USER_EXISTS
 ドメイン ユーザーは既に接続されているか、このプロバイダーのオンライン ID に関連付けられています。
ERROR_INVALID_ACCOUNT_NAME
 オンライン ユーザー名の形式が無効です。

解説

資格情報がセキュリティで保護されたデスクトップで収集される場合、システム コンテキストで AuthBuffer パラメーターを暗号化できます。 その場合、ID プロバイダーは現在のプロセスで資格情報を復号化できません。 バッファーを復号化するには、ID プロバイダーがシステム コンテキストで実行されているプロセスに資格情報を送信する必要があります。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー identityprovider.h

関連項目

IConnectedIdentityProvider