ICertView::OpenConnection 方法 (certview.h)

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)
Library Certidl.lib
DLL Certadm.dll

另请参阅

ICertConfig

ICertView

ICertView2

ICertView::OpenView