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

Article
08/22/2023

La méthode OpenConnection établit une connexion avec un serveur Certificate Services.

Syntaxe

HRESULT OpenConnection(
  [in] const BSTR strConfig
);

Paramètres

[in] strConfig

Représente une chaîne de configuration valide pour le serveur des services de certificats. La chaîne de configuration se présente sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur et CANAME est le nom commun de l’autorité de certification entrée lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Une fois cette méthode terminée, l’objet ICertView dispose d’une connexion au serveur des services de certificats spécifié dans le paramètre strConfig .

Pour fermer la connexion, appelez la fonction Release .

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certview.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll