SetupRemoveSectionFromDiskSpaceListA-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 funktion SetupRemoveSectionFromDiskSpaceList entfernt die dateilösch- oder kopiervorgänge, die in einem abschnitt Kopieren von Dateien einer INF-Datei aus einer Speicherplatzliste aufgeführt sind.
Syntax
WINSETUPAPI BOOL SetupRemoveSectionFromDiskSpaceListA(
[in] HDSKSPC DiskSpace,
[in] HINF InfHandle,
[in] HINF ListInfHandle,
[in] PCSTR SectionName,
[in] UINT Operation,
[in] PVOID Reserved1,
[in] UINT Reserved2
);
Parameter
[in] DiskSpace
Behandeln Sie die Liste des Speicherplatzes.
[in] InfHandle
Handle to an open INF file that contains the SourceDisksFiles section. Wenn ListInfHandle- nicht angegeben ist, muss diese INF-Datei auch den Abschnitt enthalten, der durch SectionNameangegeben wird.
[in] ListInfHandle
Optionaler Handle für eine geöffnete INF-Datei, die den Abschnitt enthält, der aus der Speicherplatzliste entfernt werden soll. Andernfalls muss InfHandle- den durch SectionNameangegebenen Abschnitt enthalten.
[in] SectionName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des "Dateien kopieren" oder Abschnitt "Dateien löschen" angibt, um sie aus der Speicherplatzliste zu entfernen.
[in] Operation
Dateivorgang, der aus der Liste entfernt werden soll. Dieser Parameter kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Ein Dateilöschvorgang. |
|
Ein Dateikopievorgang. |
[in] Reserved1
Muss null sein.
[in] Reserved2
Muss null sein.
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
Die Dateivorgänge, die von der funktion SetupRemoveSectionFromDiskSpaceList entfernt wurden, sind in der Regel diejenigen, die der Liste mithilfe der SetupAddSectionToDiskSpaceList Funktion hinzugefügt wurden, obwohl dies keine Anforderung ist. Die SetupRemoveSectionFromDiskSpaceList--Funktion ignoriert Dateien im INF-Abschnitt, die nicht in der Speicherplatzliste aufgeführt sind.
Für diese Funktion ist eine Windows INF-Datei erforderlich. Einige ältere INF-Dateiformate werden möglicherweise nicht unterstützt.
Anmerkung
Der header setupapi.h definiert SetupRemoveSectionFromDiskSpaceList als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |