TLSGetServerCertificate-Funktion

Gibt das Zertifikat des Remotedesktop-Lizenzservers zurück.

Hinweis

Diese Funktion verfügt über keine zugeordnete Headerdatei oder Importbibliothek. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit Mstlsapi.dll verwenden.

Syntax

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

Parameter

hHandle [in]

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

bSignCert [in]

TRUE , wenn Signaturzertifikat, FALSE bei Austauschzertifikat.

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 abzurufen.

RPC_S_INVALID_ARG

Das Argument war ungültig.

Anforderungen

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

Siehe auch

TLSConnectToLsServer