TLSGetServerCertificate-Funktion

Gibt das Zertifikat des Remotedesktop-Lizenzservers zurück.

Hinweis

Dieser Funktion ist keine Headerdatei oder Importbibliothek zugeordnet. Zum Aufrufen dieser Funktion müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Mstlsapi.dll.

Syntax

DWORD WINAPI TLSGetServerCertificate(
  _In_  TLS_HANDLE hHandle,
  _In_  BOOL       bSignCert,
  _Out_ LPBYTE     *ppbCertBlob,
  _Out_ LPDWORD    lpdwCertBlobLen,
  _Out_ PDWORD     pdwErrCode
);

Parameter

hHandle [ In]

Handle für einen Remotedesktop Lizenzserver, der durch einen Aufruf der TLSConnectToLsServer-Funktion geöffnet wird.

bSignCert [ In]

TRUE, wenn Signaturzertifikat, FALSE, wenn Zertifikat austauschen.

ppbCertBlob [ out]

Zeiger auf eine Variable, die einen Zeiger auf einen Puffer empfängt, der das Zertifikat enthält.

lpdwCertBlobLen [ out]

Zeiger auf eine Variable, die die Größe des zurückgegebenen Zertifikats empfängt.

pdwErrCode [ out]

Zeiger auf eine Variable, die den Fehlercode empfängt.

LSERVER _ S _ SUCCESS (0)

Der Aufruf ist erfolgreich.

TLS _ W _ SELFSIGN _ CERTIFICATE (4007)

Das zurückgegebene Zertifikat ist ein selbstsigniertes Zertifikat.

TLS _ W _ TEMP _ SELFSIGN _ CERT (4009)

Das zurückgegebene Zertifikat ist temporär.

TLS _ E _ ACCESS _ DENIED (5003)

Zugriff verweigert:

TLS _ E _ ALLOCATE _ HANDLE (5007)

Der Server ist zu ausgelastet, um die Anforderung zu verarbeiten.

TLS _ E _ NO _ CERTIFICATE (5022)

Ein Zertifikat kann nicht abgerufen werden.

Rückgabewert

Diese Funktion gibt die folgenden möglichen Rückgabewerte zurück.

RPC _ S _ OK

Der Aufruf war erfolgreich. Überprüfen Sie den Wert des pdwErrCode-Parameters, um den Rückgabecode für den Aufruf zu erhalten.

RPC _ S _ INVALID _ ARG

Das Argument war ungültig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
DLL
Mstlsapi.dll

Weitere Informationen

TLSConnectToLsServer