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