Metode IEnroll::createPKCS10WStr (xenroll.h)

[Metode ini tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Metode createPKCS10WStr membuat permintaan sertifikat PKCS #10 yang dikodekan base64. Metode ini pertama kali didefinisikan dalam antarmuka IEnroll .

Permintaan sertifikat PKCS #10 yang dikodekan base64 ini (dalam formulir BSTR ) dapat dikirimkan ke otoritas sertifikasi untuk meminta agar sertifikat dikeluarkan kepada orang atau entitas yang informasinya dikandungnya.

Sintaks

HRESULT createPKCS10WStr(
  [in]  LPCWSTR          DNName,
  [in]  LPCWSTR          Usage,
  [out] PCRYPT_DATA_BLOB pPkcs10Blob
);

Parameter

[in] DNName

String Unicode yang dihentikan null yang berisi nama khusus (DN) entitas tempat permintaan dibuat. Dalam parameter ini, nama DN harus mengikuti konvensi penamaan X.500 . Misalnya "CN=User, O=Microsoft". Jika awalan dua huruf tidak ada, pengidentifikasi objek (OID) dapat disediakan sebagai gantinya.

[in] Usage

String Unicode yang dihentikan null yang berisi OID yang menjelaskan tujuan sertifikat yang dihasilkan. Misalnya, sertifikat Authenticode Individu atau Komersial, atau Autentikasi Klien. Anda juga dapat menentukan beberapa OID yang dipisahkan oleh koma.

OID diteruskan ke permintaan PKCS #10. Untuk ekstensibilitas umum dan kemudahan pemahaman, kontrol tidak mencoba memahami OID tujuan tertentu. Oleh karena itu, jika Anda menentukan OID Autentikasi Klien, kunci yang dihasilkan masih akan menjadi kunci tanda tangan, bukan kunci pertukaran.

[out] pPkcs10Blob

Pointer ke CRYPT_DATA_BLOB yang menerima permintaan sertifikat PKCS10 yang dikodekan base64.

Setelah Anda selesai menggunakan memori ini, bebaskan dengan meneruskan anggota pbData struktur ini ke fungsi CoTaskMemFree .

Mengembalikan nilai

Jika metode berhasil, metode mengembalikan S_OK dan pPkcs10Blob berisi permintaan PKCS #10 yang dikodekan base64 yang dapat langsung diposting ke server web untuk diproses.

Jika metode gagal, metode mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Secara default, Penyedia Kriptografi Dasar Microsoft digunakan, PROV_RSA_FULL adalah jenis penyedia, kunci tanda tangan dibuat, dan set kunci baru yang unik dibuat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	xenroll.h
Pustaka	Uuid.lib
DLL	Xenroll.dll

Lihat juga

IEnroll