Función CryptCATAdminCalcHashFromFileHandle (mscat.h)

Artículo
02/29/2024

[La función CryptCATAdminCalcHashFromFileHandle está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función CryptCATAdminCalcHashFromFileHandle calcula el hash de un archivo. Esta función no tiene ninguna biblioteca de importación asociada. Debe usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Wintrust.dll.

Sintaxis

BOOL CryptCATAdminCalcHashFromFileHandle(
  [in]      HANDLE hFile,
  [in, out] DWORD  *pcbHash,
  [in]      BYTE   *pbHash,
  [in]      DWORD  dwFlags
);

Parámetros

[in] hFile

Identificador del archivo cuyo hash se está calculando. Este parámetro no puede ser NULL y debe ser un identificador de archivo válido.

[in, out] pcbHash

Puntero a una variable DWORD que contiene el número de bytes en pbHash. Tras la entrada, establezca pcbHash en el número de bytes asignados para pbHash. Tras la devolución, pcbHash contiene el número de bytes devueltos en pbHash. Si pbHash se pasa como NULL, pcbHash contiene el número de bytes que se asignarán para pbHash.

[in] pbHash

Puntero a un búfer BYTE que recibe el hash. Si este parámetro se pasa como NULL, pcbHash contiene el número de bytes que se asignarán para pbHash y se puede realizar una llamada posterior para recuperar el hash.

[in] dwFlags

Este parámetro está reservado para uso futuro y debe establecerse en cero.

Valor devuelto

El valor devuelto es TRUE si la función se realiza correctamente; FALSE si se produce un error en la función. Si se devuelve FALSE , llame a la función GetLastError para determinar el motivo del error. Si no se ha asignado suficiente memoria para pbHash, la función CryptCATAdminCalcHashFromFileHandle establecerá el último error en ERROR_INSUFFICIENT_BUFFER.

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	mscat.h
Library	Wintrust.lib
Archivo DLL	Wintrust.dll