Condividi tramite


Funzione SslLookupCipherLengths

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