Método ICertView::OpenConnection (certview.h)

Artículo
02/23/2024

El método OpenConnection establece una conexión con un servidor de Servicios de certificados.

Sintaxis

HRESULT OpenConnection(
  [in] const BSTR strConfig
);

Parámetros

[in] strConfig

Representa una cadena de configuración válida para el servidor de Servicios de certificados. La cadena de configuración tiene el formato COMPUTERNAME\CANAME, donde COMPUTERNAME es el nombre de red del servidor y CANAME es el nombre común de la entidad de certificación especificada durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Tras completar correctamente este método, el objeto ICertView tendrá una conexión con el servidor de Servicios de certificados especificado en el parámetro strConfig .

Para cerrar la conexión, llame a la función Release .

Ejemplos

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

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certview.h (incluye Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll