Função SslLookupCipherLengths
A função SslLookupCipherLengths retorna uma estrutura NCRYPT_SSL_CIPHER_LENGTHS que contém os comprimentos de cabeçalho e trailer do protocolo de entrada, do pacote de criptografia e do tipo de chave.
Sintaxe
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
);
Parâmetros
-
hSslProvider [in]
-
O identificador da instância do provedor de protocolo SSL ( Secure Sockets Layer ).
-
dwProtocol [in]
-
Um dos valores do Identificador de Protocolo do Provedor de SSL do CNG .
-
dwCipherSuite [in]
-
Um dos valores do Identificador do Pacote de Criptografia do Provedor de SSL do CNG .
-
dwKeyType [in]
-
Um dos valores do Identificador de Tipo de Chave do Provedor CNG SSL . Para tipos de chave que não são criptografia de curva elíptica (ECC), defina esse parâmetro como zero.
-
pCipherLengths [out]
-
Um ponteiro para um buffer para receber a estrutura NCRYPT_SSL_CIPHER_LENGTHS .
-
cbCipherLengths [in]
-
O comprimento, em bytes, do buffer apontado pelo parâmetro pCipherLengths .
-
dwFlags [in]
-
Esse parâmetro é reservado para uso futuro e deve ser definido como zero.
Valor retornado
Se a função for bem-sucedida, ela retornará zero.
Se a função falhar, ela retornará um valor de erro diferente de zero.
Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.
| Retornar código/valor | Descrição |
|---|---|
|
O parâmetro hSslProvider contém um ponteiro que não é válido. |
|
O parâmetro pCipherLengths é definido como NULL ou o comprimento do buffer especificado pelo cbCipherLengths é muito curto. |
|
O parâmetro dwFlags deve ser definido como zero. |
Comentários
A função SslLookupCipherLengths é chamada para conversas TLS ( protocolo TLS) 1.1 ou posteriores para consultar os comprimentos de cabeçalho e trailer para o protocolo solicitado, o pacote de criptografia e o tipo de chave.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| DLL |
|