Função SslGetCipherSuitePRFHashAlgorithm
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 |
|---|---|
|
O parâmetro hSslProvider contém um ponteiro que não é válido. |
|
O parâmetro szPRFHash é definido como NULL. |
|
Não há suporte para a função selecionada na versão especificada da interface. |
|
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 |
|
| DLL |
|