ICertView::Metode OpenConnection (certview.h)

Artikel
02/23/2024

Metode OpenConnection membuat koneksi dengan server Layanan Sertifikat.

Sintaks

HRESULT OpenConnection(
  [in] const BSTR strConfig
);

Parameter

[in] strConfig

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

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

Setelah berhasil menyelesaikan metode ini, objek ICertView akan memiliki koneksi ke server Layanan Sertifikat yang ditentukan dalam parameter strConfig .

Untuk menutup koneksi, panggil fungsi Rilis .

Contoh

ICertView *   pCertView = NULL;
BSTR          strCertServ = NULL;
HRESULT       hr;

// Initialize COM.
hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);

if (FAILED(hr))
{
    printf("Failed CoInitializeEx\n");
    goto error;
}
// Get pointer to the ICertView interface.
hr = CoCreateInstance(CLSID_CCertView,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_ICertView,
                      (void **)&pCertView);
if (FAILED(hr))
{
    printf("Failed CoCreateInstance\n");
    goto error;
}
// The use of '\\' is necessary to represent a single backslash.
strCertServ = SysAllocString(TEXT("Server01\\ABCCertServ"));
// Open the connection to the Certificate Services server.
hr = pCertView->OpenConnection(strCertServ);
if (FAILED(hr))
{
    printf("Failed OpenConnection!\n");
    goto error;
}
else
    // Established successful connection; use view as appropriate.
    // ...
    // Done using objects; free resources.
error: 
    if (NULL != pCertView)
        pCertView->Release();
    if (NULL != strCertServ)
        SysFreeString(strCertServ);
    // Free COM resources.
    CoUninitialize();

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