Bagikan melalui


Metode IX509CertificateRequestPkcs10::InitializeDecode (certenroll.h)

Metode InitializeDecode mendekode permintaan sertifikat PKCS #10 yang ditandatangani atau tidak ditandatangani yang ada dan menggunakannya untuk menginisialisasi objek permintaan PKCS #10 baru. Permintaan yang ada terkandung dalam array byte yang telah dikodekan dengan menggunakan Distinguished Encoding Rules (DER) seperti yang didefinisikan oleh standar Abstract Syntax Notation One (ASN.1). Array byte diwakili oleh string yang merupakan urutan biner murni atau dikodekan Unicode.

Sintaks

HRESULT InitializeDecode(
  [in] BSTR         strEncodedData,
  [in] EncodingType Encoding
);

Parameter

[in] strEncodedData

Variabel BSTR yang berisi permintaan yang dikodekan DER. Untuk informasi selengkapnya, lihat Keterangan.

[in] Encoding

Nilai enumerasi EncodingType yang menentukan jenis pengodean Unicode yang diterapkan ke string input yang berisi permintaan yang dikodekan DER. Nilai defaultnya adalah XCN_CRYPT_STRING_BASE64.

Menampilkan nilai

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 permintaan sertifikat telah diinisialisasi.

Keterangan

Metode InitializeDecode mendekode permintaan PKCS #10 yang ada dan menggunakan informasi yang diambil untuk menginisialisasi koleksi berikut untuk objek permintaan baru:

Metode ini juga:

Secara default, metode InitializeDecode mengasumsikan bahwa permintaan sertifikat yang akan didekodekan adalah untuk pengguna akhir. Dimulai dengan Windows 8 dan Windows Server 2012, Anda dapat mengubah perilaku default ini. Setelah membuat instans antarmuka IX509CertificateRequestPkcs10 , panggil InitializeDecode dengan mengatur parameter Pengodean ke XCN_CRYPT_STRING_BINARY dan parameter strEncodedData ke salah satu nilai berikut:

Nilai Deskripsi
L"ContextMachine" Permintaan sertifikat yang dikodekan adalah untuk komputer.
L"ContextUser" Permintaan sertifikat yang dikodekan adalah untuk pengguna akhir.
L"ContextAdministratorForceMachine" Sertifikat yang dikodekan sedang diminta oleh administrator yang bertindak atas nama komputer.
 

Kemudian, panggil metode InitializeDecode lagi dengan sertifikat yang dikodekan yang diatur dalam argumen strEncodedData .

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

IX509CertificateRequestPkcs10