Metode ICspInformation::InitializeFromType (certenroll.h)

  • Artikel

Metode InitializeFromType menginisialisasi objek dari penyedia kriptografi default.

Sintaks

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Parameter

[in] Type

Nilai enumerasi X509ProviderType yang menentukan jenis penyedia.

  • Jika Anda menentukan XCN_PROV_NONE dan mengatur parameter pAlgorithm ke nilai selain NULL, penyedia API Kriptografi default: Generasi Berikutnya (CNG) digunakan.
  • Jika Anda menentukan nilai selain XCN_PROV_NONE dan mengatur parameter pAlgorithm ke NULL, penyedia layanan kriptografi (CSP) warisan default akan digunakan.

[in, optional] pAlgorithm

Penunjuk ke antarmuka IObjectId yang mewakili OID algoritma. Parameter ini bersifat opsional dan dapat berupa NULL. Untuk informasi selengkapnya, lihat parameter Jenis .

[in] MachineContext

Variabel VARIANT_BOOL yang menunjukkan apakah akan menggunakan komputer atau konteks pengguna untuk menentukan penyedia default untuk jenis penyedia yang ditentukan. Tentukan VARIANT_TRUE untuk komputer dan VARIANT_FALSE untuk pengguna.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Mengembalikan kode/nilai Deskripsi
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Objek sudah diinisialisasi.

Keterangan

Metode InitializeFromType memvalidasi jenis yang ditentukan dan menyimpannya di properti Type , mengambil penyedia default, dan mengatur nilai properti berikut pada objek ICspInformation :

Metode menambahkan algoritma yang tersedia ke koleksi ICspAlgorithms yang dikembalikan oleh properti CspAlgorithms . Panggil metode InitializeFromName untuk menginisialisasi objek dari nama CSP.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

Lihat juga

ICspInformation