次の方法で共有

CRYPTUI_VIEWCERTIFICATE_STRUCTA構造体 (cryptuiapi.h)

  • [アーティクル]

CRYPTUI_VIEWCERTIFICATE_STRUCT 構造体には、表示する証明書に関する情報が含まれています。 この構造体は、CryptUIDlgViewCertificate 関数で使用されます。

構文

typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA {
  DWORD             dwSize;
  HWND              hwndParent;
  DWORD             dwFlags;
  LPCSTR            szTitle;
  PCCERT_CONTEXT    pCertContext;
  LPCSTR            *rgszPurposes;
  DWORD             cPurposes;
  union {
    CRYPT_PROVIDER_DATA const *pCryptProviderData;
    HANDLE                    hWVTStateData;
  };
  BOOL              fpCryptProviderDataTrustedUsage;
  DWORD             idxSigner;
  DWORD             idxCert;
  BOOL              fCounterSigner;
  DWORD             idxCounterSigner;
  DWORD             cStores;
  HCERTSTORE        *rghStores;
  DWORD             cPropSheetPages;
  LPCPROPSHEETPAGEA rgPropSheetPages;
  DWORD             nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;

メンバーズ

dwSize

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

hwndParent

CryptUIDlgViewCertificateによって生成されたダイアログ ボックスの親であるウィンドウへのハンドル。

dwFlags

このメンバーには、次の値のうち 1 つ以上を指定できます。

価値 意味
CRYPTUI_HIDE_HIERARCHYPAGE
 [認定パス] ページが無効になっています。
CRYPTUI_HIDE_DETAILPAGE
 [の詳細] ページが無効になっています。
CRYPTUI_DISABLE_EDITPROPERTIES
 ユーザーはプロパティを変更できません。
CRYPTUI_ENABLE_EDITPROPERTIES
 ユーザーはプロパティを変更できます。
CRYPTUI_DISABLE_ADDTOSTORE
 [ のインストール] ボタンが無効になっています。
CRYPTUI_ENABLE_ADDTOSTORE
 [ のインストール] ボタンが有効になっています。
CRYPTUI_ACCEPT_DECLINE_STYLE
 ユーザーが決定を承諾または拒否できるページまたはボタンは無効になります。
CRYPTUI_IGNORE_UNTRUSTED_ROOT
 信頼されていないルート エラーは無視されます。
CRYPTUI_DONT_OPEN_STORES
 既知の信頼されたストアは、チェーンの構築には使用されません。
CRYPTUI_ONLY_OPEN_ROOT_STORE
 既知の信頼されたルート ストアは、チェーンの構築には使用されません。
CRYPTUI_WARN_UNTRUSTED_ROOT
 リモート コンピューターで証明書を表示する場合にのみ使用します。 このフラグを使用する場合、rghStores の最初の要素は、リモート コンピューター上のルート ストアのハンドルである必要があります。
CRYPTUI_ENABLE_REVOCATION_CHECKING
 既定の動作で失効チェックを有効にします。 既定の動作では、ルート証明書を除く証明書チェーン全体の失効チェックを有効にします。 pCryptProviderData も、hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。
CRYPTUI_WARN_REMOTE_TRUST
 リモート コンピューターの証明書チェーンを構築するときに、リモート コンピューターでチェーンが信頼されていない可能性があることを警告します。
CRYPTUI_DISABLE_EXPORT
 このフラグを設定すると、詳細 ページで [ファイル にコピー] ボタン 無効になります。
CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT
 証明書チェーン内のリーフ証明書でのみ失効チェックを有効にします。 pCryptProviderData も、hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN
 証明書チェーン内の各証明書で失効チェックを有効にします。 pCryptProviderData も、hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。

ルート証明書には失効チェックを許可する情報がほとんど含まれないため、通常、このオプションを使用すると、CryptUIDlgViewCertificate 関数が失敗することが予想されます。 CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOTを使用することをお勧めします。
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT
 ルート証明書を除き、証明書チェーン内の各証明書で失効チェックを有効にします。 これは、証明書失効チェックに使用する推奨オプションです。 pCryptProviderData も、hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。

注 このフラグは、CRYPTUI_ENABLE_REVOCATION_CHECKINGと同じです。
CRYPTUI_DISABLE_HTMLLINK
 [証明書の] ダイアログ ボックスの [HTML ヘルプ] ボタン (?) を無効にします。
CRYPTUI_DISABLE_ISSUERSTATEMENT
 [証明書 の ] ダイアログ ボックスの [全般] タブの [発行者ステートメントの] ボタンを無効にします。
CRYPTUI_CACHE_ONLY_URL_RETRIEVAL
 オンライン失効チェックを無効にします。 CryptUIDlgViewCertificate 関数がローカル キャッシュを使用して証明書を取得し、ネットワークから証明書を取得しないようにするには、このフラグを設定します。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: このフラグはサポートされていません。

szTitle

ウィンドウのタイトルを含む null で終わる文字列へのポインター。

pCertContext

表示する証明書コンテキストを含む CERT_CONTEXT 構造体へのポインター。

rgszPurposes

この証明書を検証する目的を含む null で終わる文字列へのポインターの配列。

cPurposes

rgszPurposes 配列内の目的の数。

pCryptProviderData

WinVerifyTrust 関数が既に証明書に対して呼び出されており、WTHelperProvDataFromStateData 関数も呼び出された場合は、WTHelperProvDataFromStateDataへの呼び出しから取得された状態構造体へのポインター 渡します。 pCryptProviderData が設定 場合は、fpCryptProviderDataTrustedUsage、idxSigner、idxCert、および fCounterSignature も設定する必要があります。

hWVTStateData

証明書 WinVerifyTrust が既に呼び出されており、WTHelperProvDataFromStateData が呼び出されなかった場合は、WINTRUST_DATA 構造体の hWVTStateData メンバーを渡します。 hWVTStateData が設定 場合 は、fpCryptProviderDataTrustedUsage、idxSigner、idxCert、および fCounterSignature も設定する必要があります。

fpCryptProviderDataTrustedUsage

WinVerifyTrust 呼び出された場合、これは証明書が信頼されたかどうかの結果です。

idxSigner

表示する署名者のインデックス。

idxCert

署名者チェーン内で表示されている証明書のインデックス。 この証明書の証明書コンテキストは、pCertContext一致している必要があります。

fCounterSigner

逆署名が表示されている場合は TRUE。 これが TRUE場合は、idxCounterSigner 有効である必要があります。

idxCounterSigner

表示するカウンター署名者のインデックス。

cStores

rghStores 内の他のストアの数、証明書チェーンを構築して検証するときに検索する証明書ストアの配列です。

rghStores

HCERTSTORE の配列は、証明書チェーンを構築および検証するときに検索する他の証明書ストアに処理します。

cPropSheetPages

ダイアログ ボックスに追加するプロパティ ページの数。

rgPropSheetPages

ダイアログ ボックスに追加するプロパティ ページの配列。 この配列内の各ページは、WM_INITDIALOG メッセージの lParam として、PROPSHEETPAGE 構造体の lParam を受け取りません。 代わりに、CRYPTUI_INITDIALOG_STRUCT 構造体へのポインターを受け取ります。 PROPSHEETPAGE 内の lParam と、ページが表示されている CERT_CONTEXT へのポインターが含まれます。

nStartPage

表示される最初のページのインデックス。 最上位ビット (0x8000) が設定されている場合、インデックスは rgPropSheetPages インデックスを作成するものと見なされます (たとえば、最上位ビットが削除された後、0x8000は rgPropSheetPages最初のページを示します)。 最上位ビットが 0 の場合、nStartPage は、既定の証明書ダイアログ ボックスのプロパティ ページの開始インデックスになります。

備考

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー cryptuiapi.h

関連項目

CryptUIDlgViewCertificate