ICertView::OpenConnection-Methode (certview.h)
Die OpenConnection-Methode stellt eine Verbindung mit einem Certificate Services-Server her.
Syntax
HRESULT OpenConnection(
[in] const BSTR strConfig
);
Parameter
[in] strConfig
Stellt eine gültige Konfigurationszeichenfolge für den Zertifikatdiensteserver dar. Die Konfigurationszeichenfolge hat das Format COMPUTERNAME\CANAME, wobei COMPUTERNAME der Netzwerkname des Servers und CANAME der allgemeine Name der Zertifizierungsstelle ist, die während der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.
Rückgabewert
VB
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Nach erfolgreichem Abschluss dieser Methode verfügt das ICertView-Objekt über eine Verbindung mit dem Certificate Services-Server, der im strConfig-Parameter angegeben ist.
Um die Verbindung zu schließen, rufen Sie die Release-Funktion auf.
Beispiele
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();
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certview.h (include Certsrv.h) |
| Bibliothek | Certidl.lib |
| DLL | Certadm.dll |