Metode IX509CertificateRequest::GetInnerRequest (certenroll.h)

Artikel
03/14/2023

Metode GetInnerRequest mengambil objek permintaan berlapis.

Sintaks

HRESULT GetInnerRequest(
  [in]  InnerRequestLevel       Level,
  [out] IX509CertificateRequest **ppValue
);

Parameter

[in] Level

Nilai enumerasi InnerRequestLevel yang menentukan tingkat amplop data yang akan diambil. Anda dapat menggunakan nilai LevelNext untuk melakukan iterasi melalui tingkat berlapis atau nilai LevelInnermost untuk mengambil objek permintaan yang paling dalam. Anda tidak dapat menentukan LevelNext untuk permintaan PKCS #10.

[out] ppValue

Alamat variabel yang menerima penunjuk ke antarmuka IX509CertificateRequest yang berisi permintaan berlapis. Panggil properti Jenis untuk menentukan apakah objek permintaan dalam adalah PKCS #10 atau permintaan CMC. Kemudian panggil QueryInterface untuk mengambil penunjuk yang sesuai.

Mengembalikan 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
CERTSRV_E_PROPERTY_EMPTY	Anda menentukan nilai permintaan LevelNext PKCS #10.

Keterangan

Objek permintaan tingkat atas dapat berupa permintaan PKCS #10, PKCS #7, atau CMC. Aturan berikut berlaku untuk objek permintaan dalam:

Permintaan PKCS #10 tidak boleh berisi objek permintaan dalam.
Permintaan PKCS #7 hanya dapat berisi objek permintaan dalam PKCS #10.
Permintaan CMC dapat berisi CMC atau objek permintaan dalam PKCS #10. Untuk permintaan CMC yang berisi permintaan CMC dalam, tidak ada batas teoritis untuk jumlah tingkat berlapis yang dapat ada sebelum permintaan PKCS #10 dalam akhir tercapai. Artinya, permintaan CMC tingkat atas dapat berisi permintaan CMC dalam yang juga berisi permintaan CMC dalam dan sebagainya.

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