Método ICertView::OpenConnection (certview.h)
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 |