Função SslGetCipherSuitePRFHashAlgorithm

  • Artigo

A função SslGetCipherSuitePRFHashAlgorithm retorna o Identificador de Algoritmo da API de Criptografia: Próxima Geração (CNG) do algoritmo de hash que é usado para aPRF (função pseudo-aleatória ) do protocolo de entrada, pacote de criptografia e tipo de chave.

Sintaxe

SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwKeyType,
  _Out_ WCHAR              szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
  _In_  DWORD              dwFlags
);

Parâmetros

hSslProvider [in]

O identificador da instância do provedor de protocolo SSL .

dwProtocol [in]

Um dos valores do Identificador de Protocolo do Provedor 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.

szPRFHash [out]

Um dos Identificadores de Algoritmo CNG para o hash que será usado para o PRF do TLS.

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.

Código/valor de retorno Descrição
NTE_INVALID_HANDLE
0x80090026L
 O parâmetro hSslProvider contém um ponteiro que não é válido.
NTE_INVALID_PARAMETER
0x80090027L
 O parâmetro szPRFHash é definido como NULL.
NTE_NOT_SUPPORTED
0x80090029L
 Não há suporte para a função selecionada na versão especificada da interface.
NTE_BAD_FLAGS
0x80090009L
 O parâmetro dwFlags deve ser definido como zero.

Comentários

Essa função SslGetCipherSuitePRFHashAlgorithm é chamada para conversas TLS 1.2 ou posteriores para consultar o algoritmo de hash que será usado no PRF do TLS.

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
Sslprovider.h
DLL
Ncrypt.dll