Funzione TLSGetServerCertificate

Articolo
06/12/2023

Restituisce il certificato del server di licenza Desktop remoto.

Nota

Questa funzione non ha alcun file di intestazione associato o una libreria di importazione. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mstlsapi.dll.

Sintassi

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

Parametri

hHandle [in]: Gestire un server di licenza desktop remoto aperto da una chiamata alla funzione TLSConnectToLsServer .
bSignCert [in]: TRUE se il certificato di firma è FALSE se il certificato di scambio.
ppbCertBlob [out]: Puntatore a una variabile che riceve un puntatore a un buffer contenente il certificato.
lpdwCertBlobLen [out]: Puntatore a una variabile che riceve le dimensioni del certificato restituito.
pdwErrCode [out]: Puntatore a una variabile che riceve il codice di errore.
LSERVER_S_SUCCESS (0): La chiamata ha esito positivo.
TLS_W_SELFSIGN_CERTIFICATE (4007): Il certificato restituito è un certificato autofirmato.
TLS_W_TEMP_SELFSIGN_CERT (4009): Il certificato restituito è temporaneo.
TLS_E_ACCESS_DENIED (5003): Accesso negato.
TLS_E_ALLOCATE_HANDLE (5007): Il server è troppo occupato per elaborare la richiesta.
TLS_E_NO_CERTIFICATE (5022): Impossibile recuperare un certificato.

Valore restituito

Questa funzione restituisce i valori restituiti seguenti.

RPC_S_OK: La chiamata ha avuto esito positivo. Controllare il valore del parametro pdwErrCode per ottenere il codice restituito per la chiamata.
RPC_S_INVALID_ARG: L'argomento non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
DLL	Mstlsapi.dll

Vedi anche

TLSConnectToLsServer

Condividi tramite