SetupGetSourceFileSizeA-Funktion (setupapi.h)
[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin für die Installation von Gerätetreibern verwendet.]
Die SetupGetSourceFileSize Funktion liest die nicht komprimierte 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 to the loaded INF file that contains the SourceDisksNames and SourceDisksFiles sections. 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 "Dateien kopieren" Abschnitt, für den die Größe abgerufen werden soll. Wenn InfContext-NULL-ist, wird der parameter FileName verwendet.
[in] FileName
Optionaler Zeiger auf eine null-terminated string containing the filename (no path), for which to return the size. Wenn dieser Parameter NULL- sowie InfContext-ist, wird der parameter Section verwendet.
[in] Section
Optionaler Zeiger auf eine null-terminated string mit dem Namen eines Abschnitts "Dateien kopieren". Wenn dieser Parameter angegeben ist, wird die Gesamtgröße aller im Abschnitt aufgeführten Dateien berechnet.
[in, out] FileSize
Zeigen Sie auf eine Variable, die die Größe der angegebenen Datei(en) in Byte empfängt.
[in] RoundingFactor
Optionaler Wert für das Runden von Dateigrößen. Alle Dateigrößen werden auf ein Vielfaches dieser Zahl aufgerundet, bevor sie der Gesamtgröße hinzugefügt werden. Das Runden ist nützlich für genauere Ermittlungen des Speicherplatzes, den eine Datei auf einem bestimmten Volume belegt, da der Aufrufer die Dateigröße auf ein Vielfaches der Clustergröße aufgerundet hat. 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Ein und nur einer der optionalen Parameter, InfContext-, FileName-und Section, muss angegeben werden.
Anmerkung
Der Header setupapi.h 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | setupapi.h |
| Library | Setupapi.lib |
| DLL- | Setupapi.dll |