Metode IEnroll4::createRequestWStr (xenroll.h)

Artikel
03/04/2024

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

Metode createRequestWStr membuat permintaan sertifikat format PKCS #10, PKCS #7, atau Manajemen Sertifikat penuh melalui CMS (CMC) dan menyimpannya dalam BLOB. Metode ini pertama kali didefinisikan dalam antarmuka IEnroll4 .

Sintaks

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

Parameter

[in] Flags

Nilai yang menentukan jenis permintaan sertifikat yang akan dibuat. Tentukan salah satu nilai berikut ini.

Nilai	Makna
XECR_CMC	CMC Penuh
XECR_PKCS10_V1_5	PKCS #10
XECR_PKCS10_V2_0	PKCS #10 versi 2
XECR_PKCS7	PKCS #7

[in] pwszDNName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama khusus (DN) entitas tempat permintaan dibuat. 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. Parameter ini mungkin NULL.

[in] pwszUsage

Penunjuk ke string Unicode yang dihentikan null yang berisi OID yang menjelaskan tujuan sertifikat yang dihasilkan, misalnya, sertifikat Authenticode individual atau komersial, atau autentikasi klien. Anda juga dapat menentukan beberapa OID yang dipisahkan oleh koma.

[out] pblobRequest

Penunjuk ke struktur CRYPT_DATA_BLOB yang menerima permintaan.

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.

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

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

IEnroll4

Bagikan melalui