Funzione SslGetServerIdentity (schannel.h)

Articolo
03/08/2023

La funzione SslGetServerIdentity ottiene l'identità del server. Questa funzione non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Schannel.dll.

Sintassi

SECURITY_STATUS SslGetServerIdentity(
  [in]  PBYTE  ClientHello,
  [in]  DWORD  ClientHelloSize,
  [out] PBYTE  *ServerIdentity,
  [out] PDWORD ServerIdentitySize,
  [in]  DWORD  Flags
);

Parametri

[in] ClientHello

Messaggio dal client.

[in] ClientHelloSize

Dimensione del messaggio client.

[out] ServerIdentity

Puntatore all'interno del messaggio in cui viene avviato il nome del server.

[out] ServerIdentitySize

Lunghezza del nome del server.

[in] Flags

Questo parametro è riservato e deve essere zero.

Valore restituito

Stato della chiamata alla funzione.

Codice restituito	Descrizione
SEC_E_OK	La funzione ha avuto esito positivo.
SEC_E_INVALID_PARAMETER	Uno dei parametri ClientHello, ServerIdentity o ServerIdentitySize è NULL.
SEC_E_INCOMPLETE_MESSAGE	Il parametro ServerIdentitySize è minore del parametro ClientHelloSize .

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	schannel.h
DLL	Schannel.dll