SetupDecompressOrCopyFileW-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 für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupDecompressOrCopyFile-Funktion kopiert eine Datei und dekomprimiert sie bei Bedarf.

Wenn eine Datei kopiert wird, muss der Aufrufer dieser Funktion über Berechtigungen zum Schreiben in das Zielverzeichnis verfügen.

Syntax

WINSETUPAPI DWORD SetupDecompressOrCopyFileW(
  [in] PCWSTR SourceFileName,
  [in] PCWSTR TargetFileName,
  [in] PUINT  CompressionType
);

Parameter

[in] SourceFileName

Dateiname der zu kopierenden Datei. Sie sollten eine NULL-Zeichenfolge verwenden. Dieser Parameter kann NULL sein. Wenn CompressionType nicht angegeben ist und die SetupDecompressOrCopyFile-Funktion die in SourceFileName angegebene Datei nicht findet, sucht die Funktion nach der Datei mit bis zu zwei alternativen Namen, "compressed-form". Wenn die Datei beispielsweise F:\x86\cmd.exe ist und nicht gefunden wird, sucht die Funktion nach F:\x86\cmd.ex_, und wenn die Datei nicht gefunden wird, wird nach F:\x86\cmd.ex$ gesucht. Wenn CompressionType angegeben ist, wird keine zusätzliche Verarbeitung für den Dateinamen ausgeführt. die Datei muss genau wie angegeben vorhanden sein, andernfalls schlägt die Funktion fehl.

[in] TargetFileName

Exakter Name der Zieldatei, die durch Dekomprimieren oder Kopieren der Quelldatei erstellt wird. Sie sollten eine NULL-Zeichenfolge verwenden.

[in] CompressionType

Optionaler Zeiger auf den Komprimierungstyp, der in der Quelldatei verwendet wird. Sie können den Komprimierungstyp ermitteln, indem Sie SetupGetFileCompressionInfo aufrufen. Wenn dieser Wert FILE_COMPRESSION_NONE ist, wird die Datei kopiert (nicht dekomprimiert), unabhängig von der Komprimierung, die in der Quelle verwendet wird. Wenn CompressionType nicht angegeben ist, bestimmt diese Routine automatisch den Komprimierungstyp.

Rückgabewert

Die SetupDecompressOrCopyFile-Funktion gibt einen Systemfehlercode zurück, der das Ergebnis des Vorgangs angibt.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der setupapi.h-Header definiert SetupDecompressOrCopyFile 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 nicht codierungsneutralem Code 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 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

SetupGetFileCompressionInfo