CryptUIDlgSelectCertificate 関数

  • [アーティクル]

CryptUIDlgSelectCertificate 関数は、ユーザーが証明書を選択できるようにするダイアログ ボックスを表示します。

構文

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

パラメーター

pcsc [in]

表示するダイアログ ボックスに関する情報を含む CRYPTUI_SELECTCERTIFICATE_STRUCT 構造体へのポインター。

戻り値

ユーザーが選択した証明書を表す CERT_CONTEXT 構造体へのポインター。 この証明書の使用が完了したら、このポインターを CertFreeCertificateContext 関数に渡して、証明書コンテキストの参照カウントをデクリメントする必要があります。

pcsc 構造体の dwFlags メンバーに CRYPTUI_SELECTCERT_MULTISELECT フラグが含まれていない場合、NULL の戻り値は、ユーザーが証明書を選択せずにダイアログ ボックスを閉じたことを意味します。

pcsc 構造体の dwFlags メンバーに CRYPTUI_SELECTCERT_MULTISELECT フラグが含まれている場合、この関数は常に NULL を返します。 選択した証明書は、pcsc の hSelectedCertStore メンバーによって表される証明書ストアに含まれます。 ストア内の証明書の数が CryptUIDlgSelectCertificate の呼び出しの前後で同じ場合、ユーザーは証明書を選択せずにダイアログ ボックスを閉じます。

注釈

CRYPTUI_SELECTCERTIFICATE_STRUCT構造体の dwFlags メンバーがCRYPTUI_SELECTCERT_LEGACYに設定されている場合は、レガシ ダイアログが表示されます。 それ以外の場合は、現在の証明書の選択ダイアログが表示されます。

要件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
サポート終了
 Windows 7 [デスクトップ アプリのみ]
ライブラリ
Cryptui.lib
[DLL]
Cryptui.dll
Unicode 名と ANSI 名
 CryptUIDlgSelectCertificateW (Unicode) と CryptUIDlgSelectCertificateA (ANSI)

関連項目

CRYPTUI_SELECTCERTIFICATE_STRUCT