Metode ICertAdmin::ResubmitRequest (certadm.h)

Artikel
02/23/2024

Metode ResubmitRequest mengirimkan permintaan sertifikat yang ditentukan ke modul kebijakan untuk otoritas sertifikasi yang ditentukan. Metode ini pertama kali diperkenalkan di antarmuka ICertAdmin .

Agar metode ini berhasil, permintaan sertifikat harus tertunda.

Sintaks

HRESULT ResubmitRequest(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [out, retval] LONG       *pDisposition
);

Parameter

[in] strConfig

Mewakili string konfigurasi yang valid untuk otoritas sertifikasi (CA) dalam bentuk COMPUTERNAME\CANAME, di mana COMPUTERNAME adalah nama jaringan server Layanan Sertifikat dan CANAME adalah nama umum otoritas sertifikasi, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig.

ResubmitRequestpenting tidak menghapus cache internal saat string konfigurasi diubah. Saat Anda mengubah string konfigurasi untuk CA, Anda harus membuat instans objek ICertAdmin baru dan memanggil metode ini lagi dengan string konfigurasi baru.

[in] RequestId

Menentukan ID permintaan untuk mengirim ulang.

[out, retval] pDisposition

Penunjuk ke disposisi permintaan.

Menampilkan nilai

C++

Jika metode berhasil dan parameter pDisposition diatur ke salah satu nilai berikut yang menentukan disposisi permintaan, metode mengembalikan S_OK.

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. Nilai ini 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

Tugas administrasi menggunakan DCOM. Kode yang memanggil metode antarmuka ini seperti yang didefinisikan dalam versi Certadm.h sebelumnya akan berjalan pada server berbasis Windows selama klien dan server menjalankan sistem operasi Windows yang sama.

Contoh

#include <windows.h>
#include <stdio.h>
#include <Certadm.h>


    long nDisp;  // disposition value
    long nReqID = <REQUESTIDHERE>;
    BSTR bstrCA = NULL;

    bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
    if (NULL == bstrCA)
    {
        printf("Memory allocation failed\n");
        goto error;
    }

    //  pCertAdmin is a previously instantiated ICertAdmin object.
    hr = pCertAdmin->ResubmitRequest(bstrCA, nReqID, &nDisp);
    if (FAILED(hr))
    {
        printf("Failed ResubmitRequest [%x]\n", hr);
        goto error;
    }
    else
        printf("ResubmitRequest disposition is %d\n", nDisp);

error:
    //  Free resources.
    if (bstrCA)
        SysFreeString(bstrCA);

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	certadm.h (termasuk Certsrv.h)
Pustaka	Certidl.lib
DLL	Certadm.dll