CRYPTUI_VIEWCERTIFICATE_STRUCTA 構造体 (cryptuiapi.h)

[アーティクル]
08/22/2023

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

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

nStartPage

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

注釈

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	cryptuiapi.h

こちらもご覧ください

CryptUIDlgViewCertificate

次の方法で共有

CRYPTUI_VIEWCERTIFICATE_STRUCTA 構造体 (cryptuiapi.h)

構文

メンバー

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース