GetExpandedNameA-Funktion (lzexpand.h)

Artikel
11/20/2024

Ruft den ursprünglichen Namen einer komprimierten Datei ab, wenn die Datei vom algorithmus Lempel-Ziv komprimiert wurde.

Syntax

INT GetExpandedNameA(
  [in]  LPSTR lpszSource,
  [out] LPSTR lpszBuffer
);

Parameter

[in] lpszSource

Der Name der komprimierten Datei.

[out] lpszBuffer

Ein Zeiger auf einen Puffer, der den ursprünglichen Namen der komprimierten Datei empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet der Rückgabewert 1.

Wenn die Funktion fehlschlägt, wird der Rückgabewert LZERROR_BADVALUE. Für diese Funktion gibt es keine erweiterten Fehlerinformationen; rufen Sie GetLastErrornicht auf.

HinweisGetExpandedName aufruft weder SetLastError noch SetLastErrorEx; Daher wirkt sich der Fehler eines Threads nicht auf den Letzten Fehlercode eines Threads aus.

Bemerkungen

Der Inhalt des Puffers, auf den der lpszBuffer Parameter verweist, ist der ursprüngliche Dateiname, wenn die Datei mithilfe der Option /r komprimiert wurde. Wenn die Option /r nicht verwendet wurde, dupliziert diese Funktion den Namen im lpszSource Parameter in den lpszBuffer Puffer.

In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Abgestützt
Server Message Block (SMB) 3.0-Protokoll	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Skalierungsdateifreigaben (SO)	Ja
Freigegebenes Clustervolumedateisystem (CsvFS)	Ja
Resilient File System (ReFS)	Ja

Anmerkung

Der lzexpand.h-Header definiert GetExpandedName 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-	lzexpand.h (einschließlich Windows.h)
Library	Lz32.lib
DLL-	Lz32.dll

Siehe auch

Dateikomprimierung und Dekomprimierung

Dateiverwaltungsfunktionen

Freigeben über