Share via

SetupGetSourceFileSizeA-Funktion (setupapi.h)

  • Artikel

[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

Siehe auch

Funktionen

Übersicht

SetupGetSourceFileLocation