SetupDecompressOrCopyFileA-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 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 SetupDecompressOrCopyFileA(
  [in] PCSTR SourceFileName,
  [in] PCSTR TargetFileName,
  [in] PUINT CompressionType
);

Parameter

[in] SourceFileName

Dateiname der zu kopierenden Datei. Sie sollten eine NULL-endende 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 z. B. F:\x86\cmd.exe ist und nicht gefunden wird, sucht die Funktion nach F:\x86\cmd.ex_. Wenn die Datei nicht gefunden wird, wird nach F:\x86\cmd.ex$ gesucht. Wenn CompressionType angegeben ist, wird für den Dateinamen keine zusätzliche Verarbeitung 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-endende Zeichenfolge verwenden.

[in] CompressionType

Optionaler Zeiger auf den Komprimierungstyp, der für die 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 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
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