MsiGetFileHashW-Funktion (msi.h)
Die MsiGetFileHash-Funktion verwendet den Pfad zu einer Datei und gibt einen 128-Bit-Hash dieser Datei zurück. Erstellungstools können MsiGetFileHash verwenden, um den Dateihash abzurufen, der zum Auffüllen der MsiFileHash-Tabelle erforderlich ist.
Windows Installer verwendet Dateihashing als Mittel, um unnötiges Kopieren von Dateien zu erkennen und zu vermeiden. Ein in der MsiFileHash-Tabelle gespeicherter Dateihash kann mit einem Hash einer vorhandenen Datei auf dem Computer des Benutzers verglichen werden.
Syntax
UINT MsiGetFileHashW(
[in] LPCWSTR szFilePath,
[in] DWORD dwOptions,
[out] PMSIFILEHASHINFO pHash
);
Parameter
[in] szFilePath
Pfad zur Datei, die gehasht werden soll.
[in] dwOptions
Der Wert in dieser Spalte muss 0 sein. Dieser Parameter ist für die zukünftige Verwendung reserviert.
[out] pHash
Zeiger auf die zurückgegebenen Dateihashinformationen.
Rückgabewert
Wert | Bedeutung |
---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Die Datei ist nicht vorhanden. |
|
Die Datei konnte nicht geöffnet werden, um Versionsinformationen abzurufen. |
|
Unerwarteter Fehler. |
Hinweise
Der gesamte 128-Bit-Dateihash wird als vier 32-Bit-Felder zurückgegeben. Die Nummerierung der vier Felder ist nullbasiert. Die von MsiGetFileHash zurückgegebenen Werte entsprechen den vier Feldern der MSIFILEHASHINFO-Struktur . Das erste Feld entspricht der Spalte HashPart1 der Tabelle MsiFileHash, das zweite Feld entspricht der Spalte HashPart2, das dritte Feld der Spalte HashPart3, und das vierte Feld entspricht der Spalte HashPart4.
Die in die MsiFileHash-Tabelle eingegebenen Hashinformationen müssen durch Aufrufen von MsiGetFileHash oder der FileHash-Methode abgerufen werden. Versuchen Sie nicht, andere Methoden zum Generieren des Dateihashs zu verwenden.
Hinweis
Der msi.h-Header definiert MsiGetFileHash als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen. |
Zielplattform | Windows |
Kopfzeile | msi.h |
Bibliothek | Msi.lib |
DLL | Msi.dll |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für