Función CryptHashCertificate2 (wincrypt.h)

Artículo
03/03/2024

La función CryptHashCertificate2 aplica un algoritmo hash a un bloque de datos mediante un proveedor hash CNG.

Sintaxis

BOOL CryptHashCertificate2(
  [in]      LPCWSTR    pwszCNGHashAlgid,
  [in]      DWORD      dwFlags,
            void       *pvReserved,
  [in]      const BYTE *pbEncoded,
  [in]      DWORD      cbEncoded,
  [out]     BYTE       *pbComputedHash,
  [in, out] DWORD      *pcbComputedHash
);

Parámetros

[in] pwszCNGHashAlgid

Dirección de una cadena Unicode terminada en null que contiene el identificador del algoritmo hash CNG del algoritmo hash que se va a usar para aplicar un algoritmo hash al certificado. Puede ser uno de los identificadores de algoritmo CNG que representa un algoritmo hash o cualquier otro identificador de algoritmo hash registrado.

[in] dwFlags

Conjunto de marcas que modifican el comportamiento de esta función. No se definen marcas para esta función.

pvReserved

Reservado para uso futuro y debe ser NULL.

[in] pbEncoded

Dirección de una matriz de bytes que se va a aplicar un algoritmo hash. El parámetro cbEncoded contiene el tamaño de esta matriz.

[in] cbEncoded

Número de elementos de la matriz pbEncoded .

[out] pbComputedHash

Dirección de un búfer que recibe el hash calculado. La variable a la que apunta el parámetro pcbComputedHash contiene el tamaño de este búfer.

[in, out] pcbComputedHash

Dirección de una variable DWORD que, en la entrada, contiene el tamaño, en bytes, del búfer pbComputedHash . Una vez que se devuelve esta función, esta variable contiene el número de bytes copiados en el búfer pbComputedHash .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero (TRUE).

Si se produce un error en la función, devuelve cero (FALSE). Para obtener información de error extendida, llame a GetLastError. Algunos de los posibles códigos de error se identifican en los temas siguientes.

BCryptOpenAlgorithmProvider

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

funciones de Administración de datos