Metode ICertServerExit::GetRequestAttribute (certif.h)

  • Artikel

Metode GetRequestAttribute mengembalikan nilai atribut bernama dari permintaan.

Sebelum memanggil metode ini, perlu memanggil ICertServerExit::SetContext.

Sintaks

HRESULT GetRequestAttribute(
  [in]  const BSTR strAttributeName,
  [out] BSTR       *pstrAttributeValue
);

Parameter

[in] strAttributeName

Nama atribut yang akan diambil.

[out] pstrAttributeValue

Penunjuk ke nilai BSTR yang akan berisi nilai atribut.

Nilai kembali

C++

Jika metode berhasil, metode mengembalikan S_OK, dan *pstrAttributeValue diatur ke BSTR yang berisi nilai atribut.

Untuk menggunakan metode ini, buat variabel jenis BSTR, atur variabel yang sama dengan NULL, dan teruskan alamat variabel ini sebagai pstrAttributeValue.

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 mewakili nilai atribut.

Keterangan

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

Atribut permintaan berikut unik untuk permintaan gaya KEYGEN.

Nama properti Jenis Deskripsi
Latihan String Untai (karakter) tantangan yang menyertai permintaan.
ExpectedChallenge String Jika string tantangan salah, maka server akan menetapkan nilai atribut permintaan ini ke tantangan yang diharapkan sehingga kegagalan dapat didiagnosis.
 

Contoh

BSTR       bstrAttribValue = NULL;
HRESULT    hr;

// Get the request attribute.
// bstrAttribName is a BSTR assigned by EnumerateAttributes.
// Also, ICertServerExit::SetContext has already been
// called by pCertServerExit.
hr = pCertServerExit->GetRequestAttribute(bstrAttribName,
                                          &bstrAttribValue);

if (FAILED(hr))
{
    printf("Failed GetRequestAttribute [%x]\n", hr);
    goto error;
}
else
{

    // Successful call. Use bstrAttribValue as needed.
    // ...
}

// Done processing. Free BSTR.
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

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

Lihat juga

ICertServerExit

ICertServerExit::SetContext