Bagikan melalui

struktur CRYPTUI_VIEWCERTIFICATE_STRUCTW (cryptuiapi.h)

Struktur CRYPTUI_VIEWCERTIFICATE_STRUCT berisi informasi tentang sertifikat yang akan dilihat. Struktur ini digunakan dalam fungsi CryptUIDlgViewCertificate.

Sintaksis

typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTW {
  DWORD             dwSize;
  HWND              hwndParent;
  DWORD             dwFlags;
  LPCWSTR           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;
  LPCPROPSHEETPAGEW rgPropSheetPages;
  DWORD             nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTW, *PCRYPTUI_VIEWCERTIFICATE_STRUCTW;

Anggota

dwSize

Ukuran, dalam byte, dari struktur CRYPTUI_VIEWCERTIFICATE_STRUCT.

hwndParent

Handel ke jendela yang merupakan induk kotak dialog yang dihasilkan oleh CryptUIDlgViewCertificate.

dwFlags

Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai Arti
CRYPTUI_HIDE_HIERARCHYPAGE
 Halaman Jalur Sertifikasi dinonaktifkan.
CRYPTUI_HIDE_DETAILPAGE
 Halaman Detail dinonaktifkan.
CRYPTUI_DISABLE_EDITPROPERTIES
 Pengguna tidak diizinkan untuk mengubah properti.
CRYPTUI_ENABLE_EDITPROPERTIES
 Pengguna diizinkan untuk mengubah properti.
CRYPTUI_DISABLE_ADDTOSTORE
 Tombol Instal dinonaktifkan.
CRYPTUI_ENABLE_ADDTOSTORE
 Tombol Instal diaktifkan.
CRYPTUI_ACCEPT_DECLINE_STYLE
 Halaman atau tombol yang memungkinkan pengguna menerima atau menolak keputusan apa pun dinonaktifkan.
CRYPTUI_IGNORE_UNTRUSTED_ROOT
 Kesalahan akar yang tidak tepercaya diabaikan.
CRYPTUI_DONT_OPEN_STORES
 Penyimpanan tepercaya yang diketahui tidak akan digunakan untuk membangun rantai.
CRYPTUI_ONLY_OPEN_ROOT_STORE
 Penyimpanan akar tepercaya yang diketahui tidak akan digunakan untuk membangun rantai.
CRYPTUI_WARN_UNTRUSTED_ROOT
 Gunakan hanya ketika melihat sertifikat pada komputer jarak jauh. Jika bendera ini digunakan, elemen pertama rghStores harus menjadi handel penyimpanan akar di komputer jarak jauh.
CRYPTUI_ENABLE_REVOCATION_CHECKING
 Aktifkan pemeriksaan pencabutan dengan perilaku default. Perilaku defaultnya adalah mengaktifkan pemeriksaan pencabutan seluruh rantai sertifikat kecuali sertifikat akar. Hanya berlaku jika anggota serikat pCryptProviderData tidak atau hWVTStateData diteruskan.
CRYPTUI_WARN_REMOTE_TRUST
 Saat membangun rantai sertifikat untuk komputer jarak jauh, peringatkan bahwa rantai mungkin tidak dipercaya pada komputer jarak jauh.
CRYPTUI_DISABLE_EXPORT
 Jika bendera ini diatur, tombol Salin ke file akan dinonaktifkan pada halaman Detail .
CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT
 Aktifkan pemeriksaan pencabutan hanya pada sertifikat daun dalam rantai sertifikat. Hanya berlaku jika anggota serikat pCryptProviderData tidak atau hWVTStateData diteruskan.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN
 Aktifkan pemeriksaan pencabutan pada setiap sertifikat dalam rantai sertifikat. Hanya berlaku jika anggota serikat pCryptProviderData tidak atau hWVTStateData diteruskan.

Catatan Karena sertifikat akar jarang berisi informasi yang memungkinkan pemeriksaan pencabutan, diharapkan bahwa penggunaan opsi ini biasanya akan mengakibatkan kegagalan fungsi CryptUIDlgViewCertificate. Opsi yang disarankan adalah menggunakan CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT
 Aktifkan pemeriksaan pencabutan pada setiap sertifikat dalam rantai sertifikat kecuali untuk sertifikat akar. Ini adalah opsi yang direkomendasikan untuk digunakan untuk pemeriksaan pencabutan sertifikat. Hanya berlaku jika anggota serikat pCryptProviderData tidak atau hWVTStateData diteruskan.

Catatan Bendera ini setara dengan CRYPTUI_ENABLE_REVOCATION_CHECKING.
CRYPTUI_DISABLE_HTMLLINK
 Nonaktifkan tombol Bantuan HTML (?) dalam kotak dialog Sertifikat .
CRYPTUI_DISABLE_ISSUERSTATEMENT
 Nonaktifkan tombol Pernyataan Penerbit pada tab Umum dari kotak dialog Sertifikat .
CRYPTUI_CACHE_ONLY_URL_RETRIEVAL
 Nonaktifkan pemeriksaan pencabutan online. Atur bendera ini untuk memastikan bahwa fungsi CryptUIDlgViewCertificate menggunakan cache lokal untuk mengambil sertifikat dan tidak mencoba mengambil sertifikat dari jaringan.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung.

szTitle

Penunjuk ke string null-terminated yang berisi judul untuk jendela.

pCertContext

Penunjuk ke struktur CERT_CONTEXT yang berisi konteks sertifikat untuk ditampilkan.

rgszPurposes

Array pointer ke string null-terminated yang berisi tujuan sertifikat ini akan divalidasi.

cPurposes

Jumlah tujuan dalam array rgszPurposes.

pCryptProviderData

Jika fungsi WinVerifyTrust telah dipanggil untuk sertifikat dan fungsi WTHelperProvDataFromStateData juga dipanggil, teruskan penunjuk ke struktur status yang diperoleh dari panggilan ke WTHelperProvDataFromStateData. Jika pCryptProviderData diatur, fpCryptProviderDataTrustedUsage, idxSigner, idxCert, dan fCounterSignature juga harus diatur.

hWVTStateData

Jika WinVerifyTrust telah dipanggil untuk sertifikat dan WTHelperProvDataFromStateData tidak dipanggil, teruskan hWVTStateData anggota struktur WINTRUST_DATA. Jika hWVTStateData diatur, fpCryptProviderDataTrustedUsage, idxSigner, idxCert, dan fCounterSignature juga harus diatur.

fpCryptProviderDataTrustedUsage

Jika WinVerifyTrust dipanggil, ini adalah hasil dari apakah sertifikat dipercaya.

idxSigner

Indeks penanda tangan yang akan dilihat.

idxCert

Indeks sertifikat yang sedang dilihat dalam rantai penanda tangan. Konteks sertifikat sertifikasi ini harus cocok dengan pCertContext.

fCounterSigner

TRUE jika countersignature sedang dilihat. Jika ini TRUE, idxCounterSigner harus valid.

idxCounterSigner

Indeks countersigner yang akan dilihat.

cStores

Jumlah penyimpanan lain di rghStores array penyimpanan sertifikat untuk dicari saat membangun dan memvalidasi rantai sertifikat.

rghStores

Array HCERTSTORE menangani ke penyimpanan sertifikat lain untuk mencari saat membangun dan memvalidasi rantai sertifikat.

cPropSheetPages

Jumlah halaman properti yang akan ditambahkan ke kotak dialog.

rgPropSheetPages

Array halaman properti untuk ditambahkan ke kotak dialog. Setiap halaman dalam array ini tidak akan menerima lParam dalam struktur PROPSHEETPAGE sebagai lParam dalam pesan WM_INITDIALOG. Sebagai gantinya, ini akan menerima pointer ke struktur CRYPTUI_INITDIALOG_STRUCT. Ini berisi lParam di PROPSHEETPAGE dan penunjuk ke CERT_CONTEXT tempat halaman ditampilkan.

nStartPage

Indeks halaman awal yang akan ditampilkan. Jika bit tertinggi (0x8000) diatur, indeks diasumsikan untuk mengindeks rgPropSheetPages (setelah bit tertinggi dilucuti, misalnya, 0x8000 akan menunjukkan halaman pertama di rgPropSheetPages). Jika bit tertinggi adalah nol, nStartPage akan menjadi indeks awal halaman properti kotak dialog sertifikat default.

Komentar

Nota

Header cryptuiapi.h mendefinisikan CRYPTUI_VIEWCERTIFICATE_STRUCT sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header cryptuiapi.h

Lihat juga

CryptUIDlgViewCertificate

  • Last updated on