Metode ICertServerPolicy::EnumerateExtensionsSetup (certif.h)

Artikel
02/23/2024

Metode EnumerateExtensionsSetup menginisialisasi penunjuk enumerasi internal ke ekstensi sertifikat pertama yang terkait dengan konteks saat ini.

Sintaks

HRESULT EnumerateExtensionsSetup(
  [in] LONG Flags
);

Parameter

[in] Flags

Parameter ini dicadangkan dan harus diatur ke nol.

Nilai kembali

VB

Jika metode berhasil, metode akan mengembalikan S_OK.

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

Keterangan

Metode SetContext harus dipanggil sebelum memanggil metode ini. Panggilan ke SetContext menentukan permintaan mana yang merupakan konteks saat ini.

Untuk mengambil ekstensi, panggil metode EnumerateExtensions . Panggilan ke EnumerateExtensions mengambil ekstensi pertama dan memindahkan indeks ke ekstensi berikutnya jika ada.

Contoh

// Set the context. The value nContext (long) would be the same
// as the context parameter in ICertPolicy::VerifyRequest.
// hr is defined as an HRESULT.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->SetContext( nContext );
if (FAILED(hr))
{
    printf("Failed SetContext [%x]\n", hr);
    goto error;
}
// Setup the enumeration.
hr = pCertServerPolicy->EnumerateExtensionsSetup( 0 );
if (FAILED(hr))
{
    printf("Failed EnumerateExtensionsSetup [%x]\n", hr);
    goto error;
}

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