ICertRequest::Metode RetrievePending (certcli.h)
Metode RetrievePending mengambil status disposisi sertifikat dari permintaan sebelumnya yang mungkin sebelumnya telah mengembalikan CR_DISP_INCOMPLETE atau CR_DISP_UNDER_SUBMISSION.
Jika status disposisi yang dihasilkan CR_DISP_ISSUED, Anda dapat mengambil sertifikat yang dikeluarkan dengan memanggil ICertRequest3::GetCertificate. Jika disposisi selain CR_DISP_ISSUED dikembalikan, panggil ICertRequest3::GetLastStatus, ICertRequest3::GetDispositionMessage, atau kedua metode untuk informasi selengkapnya.
Sintaks
HRESULT RetrievePending(
[in] LONG RequestId,
[in] const BSTR strConfig,
[out, retval] LONG *pDisposition
);
Parameter
[in] RequestId
ID permintaan yang sebelumnya telah mengembalikan CR_DISP_INCOMPLETE atau CR_DISP_UNDER_SUBMISSION.
[in] strConfig
Mewakili string konfigurasi yang valid untuk server Layanan Sertifikat. String dapat berupa URL HTTPS untuk server pendaftaran atau dalam bentuk ComputerName\CAName, di mana ComputerName adalah nama jaringan server, dan CAName adalah nama umum otoritas sertifikasi, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.
Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: URL HTTPS tidak didukung sebagai input.
[out, retval] pDisposition
Penunjuk ke nilai disposisi permintaan.
Menampilkan nilai
C++
Jika metode berhasil, metode mengembalikan S_OK.Setelah berhasil menyelesaikan fungsi ini, *pDisposition diatur ke salah satu nilai dalam tabel berikut.
Jika metode gagal, metode mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.
VB
Nilai yang dikembalikan menentukan disposisi permintaan. Disposisi adalah salah satu nilai berikut.Menampilkan kode | Deskripsi |
---|---|
|
Permintaan tidak selesai |
|
Permintaan gagal |
|
Permintaan ditolak |
|
Sertifikat dikeluarkan |
|
Sertifikat dikeluarkan secara terpisah |
|
Permintaan diambil di bawah pengajuan |
Keterangan
Panggilan yang berhasil ke metode ini menghasilkan peristiwa EXITEVENT_CERTRETRIEVEPENDING. Modul keluar aktif akan menerima pemberitahuan peristiwa ini (dengan panggilan ke ICertExit3::Notify) jika modul keluar yang ditentukan peristiwa ini saat memanggil ICertExit3::Initialize.
Contoh
BSTR bstrCA = NULL;
long nReqID, nDisp;
// In this example, the request ID is hard-coded.
nReqID = 1234;
// Note use of two '\' in C++ to produce one '\'.
bstrCA = SysAllocString(L"server01\\myCAName");
// pCertRequest is previously instantiated ICertRequest
// object pointer. Retrieve the status for the specified request.
hr = pCertRequest->RetrievePending( nReqID, bstrCA, &nDisp );
if (FAILED(hr))
{
printf("Failed RetrievePending [%x]\n", hr);
goto error;
}
else
{
// Use the disposition value as needed...
}
// Free BSTR resource.
if ( NULL != bstrCA )
SysFreeString( bstrCA );
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 | certcli.h (termasuk Certsrv.h) |
Pustaka | Certidl.lib |
DLL | Certcli.dll |