TlsGetServerCertificate, fonction

Article
06/12/2023

Retourne le certificat du serveur de licences Bureau à distance.

Notes

Cette fonction n’a pas de fichier d’en-tête associé ni de bibliothèque d’importation. Pour appeler cette fonction, vous devez créer un fichier d’en-tête défini par l’utilisateur et utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Mstlsapi.dll.

Syntaxe

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

Paramètres

hHandle [in]: Gérez vers un serveur de licences Bureau à distance ouvert par un appel à la fonction TLSConnectToLsServer .
bSignCert [in]: TRUE si le certificat de signature, FALSE si le certificat d’échange est échangé.
ppbCertBlob [out]: Pointeur vers une variable qui reçoit un pointeur vers une mémoire tampon qui contient le certificat.
lpdwCertBlobLen [out]: Pointeur vers une variable qui reçoit la taille du certificat retourné.
pdwErrCode [out]: Pointeur vers une variable qui reçoit le code d’erreur.
LSERVER_S_SUCCESS (0): L’appel est réussi.
TLS_W_SELFSIGN_CERTIFICATE (4007): Le certificat retourné est un certificat auto-signé.
TLS_W_TEMP_SELFSIGN_CERT (4009): Le certificat retourné est temporaire.
TLS_E_ACCESS_DENIED (5003): Accès refusé.
TLS_E_ALLOCATE_HANDLE (5007): Le serveur est trop occupé pour traiter la demande.
TLS_E_NO_CERTIFICATE (5022): Impossible de récupérer un certificat.

Valeur retournée

Cette fonction retourne les valeurs de retour possibles suivantes.

RPC_S_OK: L’appel a réussi. Vérifiez la valeur du paramètre pdwErrCode pour obtenir le code de retour de l’appel.
RPC_S_INVALID_ARG: L'argument n'était pas valide.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
DLL	Mstlsapi.dll

Voir aussi

TLSConnectToLsServer

Partager via