ICertView：：OpenConnection 方法 (certview.h)

發行項
02/26/2024

OpenConnection 方法會建立與憑證服務伺服器的連線。

語法

HRESULT OpenConnection(
  [in] const BSTR strConfig
);

參數

[in] strConfig

表示憑證服務伺服器的有效組態字串。組態字串的格式為 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是伺服器的網路名稱，而 CANAME 是憑證服務設定期間所輸入證書頒發機構單位的一般名稱。如需設定字串名稱的相關信息，請參閱 ICertConfig。

傳回值

VB

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

備註

成功完成這個方法之後， ICertView 物件將會與 strConfig 參數中指定的憑證服務伺服器連線。

若要關閉連接，請呼叫 Release 函式。

範例

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();

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	certview.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll