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