次の方法で共有

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終了文字列へのポインター。 これは、credUIPromptForCredentials または credUICmdLinePromptForCredentials に pszTargetName と同じ値を渡す必要があります

[in] bConfirm

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

戻り値

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

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

備考

手記

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

必要条件

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