Compartir a través de

Función CryptHashSessionKey (wincrypt.h)

  • Artículo
Importante Esta API está en desuso. El software nuevo y existente debe empezar a usar las API cryptography Next Generation. Microsoft puede quitar esta API en futuras versiones.
 
La función CryptHashSessionKey calcula el hash criptográfico de un objeto de clave de sesión . Se puede llamar a esta función varias veces con el mismo identificador hash para calcular el hash de varias claves. Las llamadas a CryptHashSessionKey se pueden intercalar con llamadas a CryptHashData.

Antes de llamar a esta función, se debe llamar a CryptCreateHash para crear el identificador de un objeto hash.

Sintaxis

BOOL CryptHashSessionKey(
  [in] HCRYPTHASH hHash,
  [in] HCRYPTKEY  hKey,
  [in] DWORD      dwFlags
);

Parámetros

[in] hHash

Identificador del objeto hash.

[in] hKey

Identificador del objeto de clave que se va a aplicar un hash.

[in] dwFlags

Se define el siguiente valor de marca.

Valor Significado
CRYPT_LITTLE_ENDIAN
0x00000001
 Cuando se establece esta marca, los bytes de la clave se aplica un hash en formato little-endian . Tenga en cuenta que de forma predeterminada (cuando dwFlags es cero), los bytes de la clave se aplica un hash en formato big-endian .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Los códigos de error precedidos por "NTE" se generan mediante el CSP concreto que usa. Siguen algunos códigos de error posibles.

Código devuelto Descripción
ERROR_INVALID_HANDLE
 Uno de los parámetros especifica un identificador que no es válido.
ERROR_INVALID_PARAMETER
 Uno de los parámetros contiene un valor que no es válido. Suele ser un puntero que no es válido.
NTE_BAD_ALGID
 El identificador hHash especifica un algoritmo que este CSP no admite.
NTE_BAD_FLAGS
 El parámetro dwFlags es distinto de cero.
NTE_BAD_HASH
 El objeto hash especificado por el parámetro hHash no es válido.
NTE_BAD_HASH_STATE
 Se intentó agregar datos a un objeto hash que ya está marcado como "finalizado".
NTE_BAD_KEY
 Se usa un algoritmo hash con clave, pero la clave de sesión ya no es válida. Este error se genera si la clave de sesión se destruye antes de que se complete la operación de hash.
NTE_BAD_UID
 No se encuentra el contexto de CSP que se especificó cuando se creó el objeto hash.
NTE_FAIL
 Se produjo un error en la función de alguna manera inesperada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wincrypt.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

CryptCreateHash

CryptGenKey

CryptHashData

Funciones hash y firma digital