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 つ以上を指定できます。
値 | 意味 |
---|---|
|
[認定パス] ページが無効になっています。 |
|
[ 詳細] ページは無効になっています。 |
|
ユーザーはプロパティを変更できません。 |
|
ユーザーはプロパティを変更できます。 |
|
[ インストール] ボタンが無効になっています。 |
|
[ インストール ] ボタンが有効になっています。 |
|
ユーザーが決定を承諾または拒否できるようにするページまたはボタンは無効になります。 |
|
信頼されていないルート エラーは無視されます。 |
|
既知の信頼されたストアは、チェーンの構築には使用されません。 |
|
既知の信頼されたルート ストアは、チェーンの構築には使用されません。 |
|
リモート コンピューターで証明書を表示する場合にのみ使用します。 このフラグを使用する場合、 rghStores の最初の要素は、リモート コンピューター上のルート ストアのハンドルである必要があります。 |
|
既定の動作で失効チェックを有効にします。 既定の動作では、ルート証明書を除く証明書チェーン全体の失効チェックを有効にします。 pCryptProviderData も hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。 |
|
リモート コンピューターの証明書チェーンを構築するときに、リモート コンピューターでチェーンが信頼されていない可能性があることを警告します。 |
|
このフラグを設定すると、[詳細] ページの [ファイルにコピー] ボタンが無効になります。 |
|
証明書チェーン内のリーフ証明書でのみ失効チェックを有効にします。 pCryptProviderData も hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。 |
|
証明書チェーン内の各証明書で失効チェックを有効にします。 pCryptProviderData も hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。
メモ ルート証明書には失効チェックを可能にする情報がほとんど含まれないため、通常、このオプションを使用すると CryptUIDlgViewCertificate 関数が失敗することが予想されます。 推奨されるオプションは、CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOTを使用することです。 |
|
ルート証明書を除き、証明書チェーン内の各証明書で失効チェックを有効にします。 これは、証明書失効チェックに使用するために推奨されるオプションです。 pCryptProviderData も hWVTStateData 共用体メンバーも渡されていない場合にのみ有効です。
メモ このフラグは、CRYPTUI_ENABLE_REVOCATION_CHECKINGと同じです。 |
|
[証明書] ダイアログ ボックスの [HTML ヘルプ] ボタン (?) を無効にします。 |
|
[証明書] ダイアログ ボックスの [全般] タブの [発行者ステートメント] ボタンを無効にします。 |
|
オンライン失効チェックを無効にします。 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 |