CredUIConfirmCredentialsA 関数 (wincred.h)

  • [アーティクル]

CredUIConfirmCredentials 関数は、収集された資格情報の有効性を確認するために、CredUIPromptForCredentials または CredUICmdLinePromptForCredentials の後に呼び出されます。 credUIConfirmCredentials は、CREDUI_FLAGS_EXPECT_CONFIRMATION フラグが "prompt" 関数 ( CredUIPromptForCredentials または CredUICmdLinePromptForCredentials) に渡され、"prompt" 関数がNO_ERROR返された場合に呼び出す必要があります。

"prompt" 関数を呼び出した後、 CredUIConfirmCredentials を呼び出す前に、呼び出し元は、資格情報を使用して pszTargetName で指定されたリソースにアクセスすることで、資格情報が実際に有効かどうかを判断する必要があります。 その検証テストの結果は、bConfirm パラメーターの CredUIConfirmCredentials に渡されます。

構文

CREDUIAPI DWORD CredUIConfirmCredentialsA(
  [in] PCSTR pszTargetName,
  [in] BOOL  bConfirm
);

パラメーター

[in] pszTargetName

資格情報のターゲットの名前 (通常はドメインまたはサーバー アプリケーション名) を含む null で終わる文字列へのポインター。 これは、pszTargetName と同じ値を CredUIPromptForCredentials または CredUICmdLinePromptForCredentials に渡す必要があります

[in] bConfirm

prompt 関数から返される資格情報が有効かどうかを指定します。 TRUE の場合、資格情報は CredUIPromptForCredentials または CredUICmdLinePromptForCredentials によって定義された資格情報マネージャーに格納されます。 FALSE の場合、資格情報は格納されず、さまざまなメモリがクリーンアップされます。

戻り値

操作の状態が返されます。 呼び出し元はこの状態をチェックして、資格情報の確認操作が成功したかどうかを判断できます。 ほとんどのアプリケーションでは、リソースへのアプリケーションの接続が既に行われているため、この状態コードは無視されます。 資格情報が確認待ちの資格情報の一覧に見つからなかったか、資格情報の書き込みまたは削除の試行が失敗したため、操作が失敗する可能性があります。 一覧で資格情報が見つからない場合は、資格情報がキューに登録されなかったか、キューに登録されている資格情報が多すぎることが原因で発生する可能性があります。 新しい資格情報がキューに登録されると、古い資格情報が破棄される前に、最大 5 つの資格情報をキューに入れることができます。

リターン コード 説明
NO_ERROR - (ゼロ)
 操作が成功したことを確認します。
ERROR_NOT_FOUND
 サブジェクト資格情報が確認待機リストに見つかりませんでした。
ERROR_INVALID_PARAMETER
 資格情報に無効なデータまたは不整合なデータが含まれていたため、待機中の資格情報を確認できませんでした。

注釈

注意

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー wincred.h
Library Credui.lib
[DLL] Credui.dll