Compartir a través de

Función MsiGetFileHashA (msi.h)

  • Artículo

La función msiGetFileHash toma la ruta de acceso a un archivo y devuelve un hash de 128 bits de ese archivo. Las herramientas de creación pueden usar MsiGetFileHash para obtener el hash de archivo necesario para rellenar la tabla msiFileHash de .

Windows Installer usa el hash de archivos como medio para detectar y eliminar la copia de archivos innecesaria. Un hash de archivo almacenado en la tabla MsiFileHash puede compararse con un hash de un archivo existente en el equipo del usuario.

Sintaxis

UINT MsiGetFileHashA(
  [in]  LPCSTR           szFilePath,
  [in]  DWORD            dwOptions,
  [out] PMSIFILEHASHINFO pHash
);

Parámetros

[in] szFilePath

Ruta de acceso al archivo que se va a aplicar hash.

[in] dwOptions

El valor de esta columna debe ser 0. Este parámetro está reservado para uso futuro.

[out] pHash

Puntero a la información hash de archivo devuelta.

Valor devuelto

Valor Significado
ERROR_SUCCESS
 La función se completó correctamente.
ERROR_FILE_NOT_FOUND
 El archivo no existe.
ERROR_ACCESS_DENIED
 No se pudo abrir el archivo para obtener información de versión.
E_FAIL
 Error inesperado.
 
 

Observaciones

El hash de archivo completo de 128 bits se devuelve como cuatro campos de 32 bits. La numeración de los cuatro campos se basa en cero. Los valores devueltos por msiGetFileHash corresponden a los cuatro campos de la estructura MSIFILEHASHINFO de . El primer campo corresponde a la columna HashPart1 de la tabla MsiFileHash, el segundo campo corresponde a la columna HashPart2, el tercer campo corresponde a la columna HashPart3 y el cuarto campo corresponde a la columna HashPart4.

La información hash especificada en la tabla MsiFileHash debe obtenerse llamando a msiGetFileHash o al método FileHash. No intente usar otros métodos para generar el hash de archivo.

Nota

El encabezado msi.h define MsiGetFileHash como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP. Consulte Windows Installer Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de Windows
encabezado de msi.h
biblioteca de Msi.lib
DLL de Msi.dll

Consulte también

de control de versiones de archivos predeterminado

MSIFILEHASHINFO

de tabla MsiFileHash de