IConnectableCredentialProviderCredential::Connect メソッド (credentialprovider.h)

IConnectableCredentialProviderCredential オブジェクトを接続します。 このメソッドは、ユーザーが [ログオン前アクセス プロバイダー] 画面の [ 送信 ] ボタンをクリックした後、 および ICredentialProviderCredential::GetSerialization が呼び出される前に呼び出されます。

構文

HRESULT Connect(
  [in] IQueryContinueWithStatus *pqcws
);

パラメーター

[in] pqcws

種類: IQueryContinueWithStatus*

IQueryContinueWithStatus オブジェクトへのポインター。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

ログオン UI は、このメソッドを呼び出すと、 IQueryContinueWithStatus インスタンスへのポインターを渡します。 このオブジェクトは、資格情報プロバイダーが引き続きネットワークへの接続を試みる必要があるかどうかを照会し、接続の試行中にユーザーにステータス メッセージを表示するために使用されます。 堅牢な資格情報プロバイダーは、ユーザー入力に応答できるように、ネットワークへの接続の試行中に QueryContinue を定期的に呼び出す必要があります。

Connect の呼び出しが成功すると、ログオン UI に [切断] ボタンがユーザーに表示されます。 ユーザーが [切断] をクリックすると、ログオン UI は IConnectableCredentialProviderCredential を実装するすべての資格情報プロバイダーで Disconnect を呼び出します。

要件

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