struktur CRYPTUI_WIZ_IMPORT_SRC_INFO (cryptuiapi.h)

[Struktur CRYPTUI_WIZ_IMPORT_SRC_INFO tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Struktur CRYPTUI_WIZ_IMPORT_SRC_INFO berisi subjek untuk diimpor ke fungsi CryptUIWizImport . Subjek dapat berupa sertifikat, daftar kepercayaan sertifikat (CTL), atau daftar pencabutan sertifikat (CRL).

Sintaks

typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO {
  DWORD   dwSize;
  DWORD   dwSubjectChoice;
  union {
    LPCWSTR        pwszFileName;
    PCCERT_CONTEXT pCertContext;
    PCCTL_CONTEXT  pCTLContext;
    PCCRL_CONTEXT  pCRLContext;
    HCERTSTORE     hCertStore;
  };
  DWORD   dwFlags;
  LPCWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;

Anggota

dwSize

Ukuran, dalam byte, dari struktur ini.

dwSubjectChoice

Menunjukkan jenis subjek yang akan diimpor. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE	Impor sertifikat yang disimpan dalam file yang dirujuk di anggota pwszFileName .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT	Impor sertifikat yang dirujuk dalam anggota pCertContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT	Impor CTL yang dirujuk dalam anggota pCTLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT	Impor CRL yang direferensikan dalam anggota pCRLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE	Impor penyimpanan sertifikat yang dirujuk di anggota hCertStore .

pwszFileName

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur dan nama file file yang berisi sertifikat yang akan diimpor. Anggota ini digunakan jika anggota dwSubjectChoice berisi CRYPTUI_WIZ_IMPORT_SUBJECT_FILE.

pCertContext

Penunjuk ke struktur CERT_CONTEXT yang berisi sertifikat yang akan diimpor. Anggota ini digunakan jika anggota dwSubjectChoice berisi CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT.

pCTLContext

Penunjuk ke struktur CTL_CONTEXT yang berisi CTL yang akan diimpor. Anggota ini digunakan jika anggota dwSubjectChoice berisi CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT.

pCRLContext

Penunjuk ke struktur CRL_CONTEXT yang berisi CRL untuk diimpor. Anggota ini digunakan jika anggota dwSubjectChoice berisi CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT.

hCertStore

Handel ke penyimpanan sertifikat untuk diimpor. Anggota ini digunakan jika anggota dwSubjectChoice berisi CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE.

dwFlags

Berisi bendera yang mengubah operasi impor. Anggota ini diperlukan jika pwszFileName berisi BLOB Personal Information Exchange (PFX). Jika tidak, anggota ini diabaikan. Anggota ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

Nilai	Makna
CRYPT_EXPORTABLE	Kunci yang diimpor ditandai sebagai dapat diekspor. Jika bendera ini tidak digunakan, panggilan ke fungsi CryptExportKey dengan handel kunci gagal.
CRYPT_USER_PROTECTED	Pengguna akan diberi tahu melalui kotak dialog atau beberapa cara lain ketika tindakan tertentu mencoba menggunakan kunci ini. Perilaku yang tepat ditentukan oleh penyedia layanan kriptografi (CSP) yang sedang digunakan. Sebelum Internet Explorer 4.0, Microsoft CSP mengabaikan bendera ini. Dimulai dengan Internet Explorer 4.0, Microsoft CSP mendukung bendera ini. Jika konteks penyedia dibuka dengan set bendera CRYPT_SILENT , menggunakan bendera ini menyebabkan kegagalan, dan kesalahan terakhir diatur ke NTE_SILENT_CONTEXT.
CRYPT_MACHINE_KEYSET	Kunci privat disimpan di bawah komputer lokal dan bukan di bawah pengguna saat ini.
CRYPT_USER_KEYSET	Kunci privat disimpan di bawah pengguna saat ini dan bukan di bawah komputer lokal, bahkan jika BLOB PFX menentukan bahwa mereka harus berada di bawah komputer lokal.

pwszPassword

Penunjuk ke string Unicode yang dihentikan null yang berisi kata sandi yang digunakan untuk mengakses kunci privat. Kata sandi diperlukan jika pwszFileName berisi BLOB PFX. Jika kata sandi tidak diperlukan, variabel bisa menjadi string kosong. Anggota ini tidak boleh NULL.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	cryptuiapi.h

Lihat juga

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport