Funzione SslLookupCipherLengths

Articolo
06/12/2023

La funzione SslLookupCipherLengths restituisce una struttura NCRYPT_SSL_CIPHER_LENGTHS che contiene le lunghezze di intestazione e trailer del protocollo di input, della suite di crittografia e del tipo di chiave.

Sintassi

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _In_  DWORD                     dwFlags
);

Parametri

hSslProvider [in]: Handle dell'istanza del provider del protocollo SSL (Secure Sockets Layer Protocol).
dwProtocol [in]: Uno dei valori CNG SSL Provider Protocol Identifier .
dwCipherSuite [in]: Uno dei valori CNG SSL Provider Cipher Suite Identifier .
dwKeyType [in]: Uno dei valori CNG SSL Provider Key Type Identifier . Per i tipi di chiave che non sono crittografia a curva ellittica (ECC), impostare questo parametro su zero.
pCipherLengths [out]: Puntatore a un buffer per ricevere la struttura NCRYPT_SSL_CIPHER_LENGTHS .
cbCipherLengths [in]: Lunghezza, in byte, del buffer a cui punta il parametro pCipherLengths .
dwFlags [in]: Questo parametro è riservato per uso futuro e deve essere impostato su zero.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, a titolo esemplificativo, quanto segue.

Codice/valore restituito	Descrizione
NTE_INVALID_HANDLE 0x80090026L	Il parametro hSslProvider contiene un puntatore non valido.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro pCipherLengths è impostato su NULL o la lunghezza del buffer specificata da cbCipherLengths è troppo breve.
NTE_BAD_FLAGS 0x80090009L	Il parametro dwFlags deve essere impostato su zero.

Commenti

La funzione SslLookupCipherLengths viene chiamata per le conversazioni TLS ( Transport Layer Security Protocol ) 1.1 o versioni successive per eseguire query sulle lunghezze di intestazione e trailer per il protocollo richiesto, la suite di crittografia e il tipo di chiave.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	Sslprovider.h
DLL	Ncrypt.dll

Share via