Share via

Metode IEnroll4::createRequestWStr (xenroll.h)

  • Artikel

[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