Metode ICertRequest::GetDispositionMessage (certcli.h)

Artikel
02/26/2024

Metode GetDispositionMessage mendapatkan pesan yang dapat dibaca manusia yang memberikan disposisi permintaan sertifikat saat ini.

Perhatikan bahwa pesan yang dikembalikan di sini mungkin memiliki detail lebih lanjut daripada kode kesalahan yang dikembalikan. Misalnya, ICertRequest3::GetLastStatus dapat mengembalikan HRESULT, sementara GetDispositionMessage akan mengembalikan alasan terperinci yang menentukan mengapa permintaan ditolak.

Sintaks

HRESULT GetDispositionMessage(
  [out] BSTR *pstrDispositionMessage
);

Parameter

[out] pstrDispositionMessage

Penunjuk ke BSTR yang berisi pesan disposisi.

Menampilkan nilai

C++

Jika metode berhasil, metode akan mengembalikan S_OK.

Setelah berhasil menyelesaikan fungsi ini, *pstrDispositionMessage diatur ke BSTR yang berisi pesan yang dapat dibaca manusia yang memberikan disposisi permintaan sertifikat saat ini. Untuk menggunakan metode ini, buat variabel jenis BSTR , atur variabel yang sama dengan NULL, dan teruskan alamat variabel ini sebagai pstrDispositionMessage. Setelah Anda selesai menggunakan BSTR, bebaskan dengan memanggil fungsi SysFreeString .

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

VB

Nilai yang dikembalikan adalah string yang berisi pesan yang dapat dibaca manusia yang memberikan disposisi permintaan sertifikat saat ini.

Keterangan

Aplikasi akan memanggil metode ini untuk mendapatkan pesan yang diambil dari server melalui panggilan sebelumnya ke ICertRequest3::Submit atau ICertRequest3::RetrievePending. Selain itu, pesan disimpan dalam database Layanan Sertifikat dan dapat dilihat oleh snap-in MMC Otoritas Sertifikasi (pilih kolom Pesan Disposisi Permintaan). Jika pesan berisi teks yang dilokalkan, pesan tersebut dilokalkan di server (berdasarkan lokal server).

Contoh

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

    BSTR    bstrDispMsg = NULL;
    // pCertRequest is previously instantiated ICertRequest object 
    // pointer. Retrieve the disposition message for the 
    // previous request.
    hr = pCertRequest->GetDispositionMessage(&bstrDispMsg);
    if (FAILED(hr))
    {
        printf("Failed GetDispositionMessage [%x]\n", hr);
        goto error;
    }
    else
    {
        // Use the disposition message as needed...
    }

    // Done processing.

error:

    // Free BSTR values.
    if (NULL != bstrCA)
        SysFreeString(bstrCA);

    if (NULL != bstrDispMsg)
        SysFreeString(bstrDispMsg);

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