SetupGetSourceFileSizeA-Funktion (setupapi.h)
[Diese Funktion ist für die Verwendung in den betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]
Die SetupGetSourceFileSize-Funktion liest die unkomprimierte Größe einer Quelldatei, die in einer INF-Datei aufgeführt ist.
Syntax
WINSETUPAPI BOOL SetupGetSourceFileSizeA(
[in] HINF InfHandle,
[in] PINFCONTEXT InfContext,
[in] PCSTR FileName,
[in] PCSTR Section,
[in, out] PDWORD FileSize,
[in] UINT RoundingFactor
);
Parameter
[in] InfHandle
Handle für die geladene INF-Datei, die die Abschnitte SourceDisksNames und SourceDisksFiles enthält. Wenn plattformspezifische Abschnitte für das System des Benutzers vorhanden sind (z. B. SourceDisksNames.x86 und SourceDisksFiles.x86), wird der plattformspezifische Abschnitt verwendet.
[in] InfContext
Optionaler Zeiger auf einen Kontext für eine Zeile in einem Abschnitt zum Kopieren von Dateien , für die die Größe abgerufen werden soll. Wenn InfContextNULL ist, wird der FileName-Parameter verwendet.
[in] FileName
Optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den Dateinamen (kein Pfad) enthält, für den die Größe zurückgegeben werden soll. Wenn dieser Parameter null und InfContext ist, wird der Section-Parameter verwendet.
[in] Section
Optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den Namen eines Abschnitts Zum Kopieren von Dateien enthält. Wenn dieser Parameter angegeben wird, wird die Gesamtgröße aller im Abschnitt aufgeführten Dateien berechnet.
[in, out] FileSize
Zeiger auf eine Variable, die die Größe der angegebenen Dateien in Byte empfängt.
[in] RoundingFactor
Optionaler Wert zum Runden von Dateigrößen. Alle Dateigrößen werden auf ein Vielfaches dieser Zahl aufgerundet, bevor sie der Gesamtgröße hinzugefügt werden. Die Rundung ist nützlich für genauere Bestimmung des Speicherplatzes, den eine Datei auf einem bestimmten Volume belegt, da sie es dem Aufrufer ermöglicht, Dateigrößen auf ein Vielfaches der Clustergröße aufzurunden. Die Rundung erfolgt nur, wenn RoundingFactor angegeben ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Es muss nur einer der optionalen Parameter angegeben werden, InfContext, FileName und Section.
Hinweis
Der Setupapi.h-Header definiert SetupGetSourceFileSize 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
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | setupapi.h |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |