ICertRequest::Metode RetrievePending (certcli.h)

Artikel
03/14/2023

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
CR_DISP_INCOMPLETE	Permintaan tidak selesai
CR_DISP_ERROR	Permintaan gagal
CR_DISP_DENIED	Permintaan ditolak
CR_DISP_ISSUED	Sertifikat dikeluarkan
CR_DISP_ISSUED_OUT_OF_BAND	Sertifikat dikeluarkan secara terpisah
CR_DISP_UNDER_SUBMISSION	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