CRYPTUI_SELECTCERTIFICATE_STRUCT構造体

CRYPTUI_SELECTCERTIFICATE_STRUCT構造体には、CryptUIDlgSelectCertificate 関数によって表示されるダイアログ ボックスに関する情報が含まれています。

構文

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

メンバー

dwSize

この構造体のサイズ (バイト単位)。

hwndParent

ダイアログ ボックスの親ウィンドウのハンドル。 この値が NULL の場合、親ウィンドウは既定のデスクトップ ウィンドウです。

dwFlags

CryptUIDlgSelectCertificate 関数の追加オプションを指定します。 次の値の 0 またはビットごとの OR を指定できます。

値	意味
CRYPTUI_SELECTCERT_ADDFROMDS	予約済み。
CRYPTUI_SELECTCERT_LEGACY	レガシ ダイアログを表示することを指定します。
CRYPTUI_SELECTCERT_MULTISELECT	ユーザーがダイアログ ボックスで複数の証明書を選択できるようにします。 このフラグが設定されている場合、 CryptUIDlgSelectCertificate 関数は常に NULL を返します。 この構造体の hSelectedCertStore メンバーには、証明書ストアへのハンドルが含まれている必要があります。 ユーザーが選択した証明書がこのストアに追加されます。
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST	暗号化 UI を画面上のウィンドウに強制的に表示します。

 

szTitle

ダイアログ ボックスの表示タイトル。 このメンバーの値が NULL の場合、"証明書の選択" の既定のタイトルが使用されます。

dwDontUseColumn

ディスプレイの列を除外するために組み合わせることができるフラグ。

値	意味
CRYPTUI_SELECT_ISSUEDTO_COLUMN 1 (0x1)	ISSUEDTO 情報を表示しないでください。
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2 (0x2)	ISSUEDBY 情報を表示しないでください。
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4 (0x4)	IntendedUse 情報は表示しないでください。
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8 (0x8)	名前情報は表示しないでください。
CRYPTUI_SELECT_LOCATION_COLUMN 16 (0x10)	位置情報を表示しません。
CRYPTUI_SELECT_EXPIRATION_COLUMN 32 (0x20)	有効期限情報は表示しないでください。

 

szDisplayString

ユーザーに指示するダイアログ ボックスに表示されるテキスト。 このメンバーの値が NULL の場合は、既定の文字列 "使用する証明書の選択" が使用されます。

pFilterCallback

ダイアログ ボックスに表示される証明書をフィルター処理する PFNCFILTERPROC コールバック関数へのポインター。

pDisplayCallback

ユーザーが表示を選択した証明書を表示する PFNCCERTDISPLAYPROC コールバック関数へのポインター。

pvCallbackData

pFilterCallback メンバーと pDisplayCallback メンバーによって指定されたコールバック関数に渡される追加データ。

cDisplayStores

rghDisplayStores 配列内の証明書ストアの数。

rghDisplayStores

ダイアログ ボックスで選択できる証明書を含むストアの配列へのポインター。

cStores

rghStores 配列内の証明書ストアの数。

rghStores

証明書チェーンを構築し、ダイアログ ボックスに表示される証明書の信頼を確認するときに検索する証明書ストアの配列へのポインター。

cPropSheetPages

rgPropSheetPages 配列内のプロパティ ページの数。

rgPropSheetPages

表示する証明書が選択されている場合に、証明書の表示ダイアログ ボックスに渡されるプロパティ ページを表す PROPSHEETPAGE 構造体の配列へのポインター。

hSelectedCertStore

呼び出し元によって作成された証明書ストアへのハンドル。 ユーザーが選択した証明書がこのストアに追加されます。 このストア内の証明書の数が CryptUIDlgSelectCertificate の呼び出しの前後で同じ場合、ユーザーは証明書を選択せずにダイアログ ボックスを閉じました。

この構造体の dwFlags メンバーに CRYPTUI_SELECTCERT_MULTISELECT フラグが含まれていない場合、このメンバーは使用されません。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
Unicode 名と ANSI 名	CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) と CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

こちらもご覧ください

CryptUIDlgSelectCertificate