Metode ICertServerExit::GetRequestProperty (certif.h)

Artikel
03/04/2024

Metode GetRequestProperty mengembalikan properti bernama dari permintaan.

Perhatikan bahwa permintaan digunakan untuk menyimpan semua status terkait untuk permintaan dan sertifikat yang akhirnya diberikan yang bukan bagian dari sertifikat. Dengan demikian, data seperti waktu pencabutan dan data disposisi disimpan dalam objek data permintaan.

Sintaks

HRESULT GetRequestProperty(
  [in]  const BSTR strPropertyName,
  [in]  LONG       PropertyType,
  [out] VARIANT    *pvarPropertyValue
);

Parameter

[in] strPropertyName

Menentukan properti yang akan diambil. Ada set stok properti sertifikat, yang disebut sebagai properti nama, yang selalu valid dan dapat diambil dengan memanggil metode ini. Untuk informasi tentang properti ini, lihat Properti Nama.

Properti lain yang valid untuk permintaan sertifikat termasuk properti permintaan.

Catatan Properti DistinguishedName dan RawName permintaan dapat diakses oleh GetRequestProperty hanya jika sertifikat diminta dengan menggunakan permintaan sertifikat PKCS #10 atau format permintaan lain yang didukung yang berisi informasi nama subjek yang dikodekan. Perhatikan bahwa permintaan KeyGen tidak berisi informasi nama subjek yang dikodekan.

Properti berikut ini unik untuk permintaan dan dapat diakses dengan menggunakan metode GetRequestProperty .

Properti permintaan	Makna
Disposition Ditandatangani panjang	Disposisi permintaan saat ini
DispositionMessage String	Pesan disposisi informasi
RawCACertificate Biner	Sertifikat untuk otoritas sertifikasi penerbit
RawRequest Biner	Byte permintaan mentah
RequestAttributes String	String atribut (dapat dipotong)
RequesterName String	Nama pemohon dalam formulir "DomainName\UserID"
RequestID Ditandatangani panjang	RequestID internal
RequestType Ditandatangani panjang	Menunjukkan permintaan PKCS #10 atau KeyGen
TerselesaikanKetika Tanggal/Waktu	Ketika diselesaikan
StatusCode Ditandatangani panjang	Kesalahan Windows untuk operasi terakhir
Dikirim Saat ini Tanggal/Waktu	Ketika tiba

Properti RequestType akan menjadi salah satu nilai berikut.

Nilai	Makna
CR_IN_PKCS7	Permintaan perpanjangan atau pendaftaran PKCS #7
CR_IN_PKCS10	Permintaan PKCS #10
CR_IN_KEYGEN	Permintaan Keygen (format Netscape)

Selain itu, properti lain dapat diatur oleh jenis permintaan tertentu, ekstensi permintaan, atau oleh atribut bernama yang diatur di header permintaan.

[in] PropertyType

Menentukan jenis properti. Jenisnya bisa menjadi salah satu jenis berikut.

Nilai	Makna
PROPTYPE_LONG	Data panjang yang ditandatangani
PROPTYPE_DATE	Tanggal/Waktu
PROPTYPE_BINARY	Data biner
PROPTYPE_STRING	Data untai (karakter) Unicode

[out] pvarPropertyValue

Penunjuk ke VARIAN yang akan berisi jenis properti permintaan.

Mengembalikan nilai

C++

Jika metode berhasil, metode mengembalikan S_OK, dan *pvarPropertyValue diatur ke VARIAN yang berisi nilai properti permintaan.

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

VB

Nilai yang dikembalikan adalah nilai properti permintaan.

Keterangan

Anda harus memanggil ICertServerExit::SetContext sebelum menggunakan metode ini.

Contoh

BSTR      bstrPropName = NULL;
VARIANT   varProp;

VariantInit( &varProp );

bstrPropName = SysAllocString(L"RequestID");

// Retrieve the request property.
// pCertServerExit has been used to call SetContext previously.
hr = pCertServerExit->GetRequestProperty( bstrPropName,
                                          PROPTYPE_LONG,
                                          &varProp );
if (FAILED(hr))
{
    printf("Failed GetRequestProperty [%x]\n", hr);
    goto error;
}
else
{
    // Successfully retrieved property; use varProp as needed.
    // ...
}

// Done processing.
VariantClear( &varProp );
if ( NULL != bstrPropName )
    SysFreeString( bstrPropName );

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certif.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certcli.dll