CheckNameLegalDOS8Dot3A-Funktion (winbase.h)

Artikel
11/20/2024

Bestimmt, ob der angegebene Name zum Erstellen einer Datei in einem FAT-Dateisystem verwendet werden kann.

Syntax

BOOL CheckNameLegalDOS8Dot3A(
  [in]            LPCSTR lpName,
  [out, optional] LPSTR  lpOemName,
  [in]            DWORD  OemNameSize,
  [out, optional] PBOOL  pbNameContainsSpaces,
  [out]           PBOOL  pbNameLegal
);

Parameter

[in] lpName

Der Dateiname im Format 8.3.

[out, optional] lpOemName

Ein Zeiger auf einen Puffer, der die OEM-Zeichenfolge empfängt, die Nameentspricht. Dieser Parameter kann NULL-sein.

[in] OemNameSize

Die Größe des lpOemName- Puffers in Zeichen. Wenn lpOemName-NULL-ist, muss dieser Parameter 0 (null) sein.

[out, optional] pbNameContainsSpaces

Gibt an, ob ein Name Leerzeichen enthält. Dieser Parameter kann NULL-sein. Wenn der Name kein gültiger 8.3 FAT-Dateisystemname ist, ist dieser Parameter nicht definiert.

[out] pbNameLegal

Wenn die Funktion erfolgreich ist, gibt dieser Parameter an, ob ein Dateiname ein gültiger 8.3 FAT-Dateiname ist, wenn die aktuelle OEM-Codeseite auf den Dateinamen angewendet wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Diese Funktion kann verwendet werden, um zu bestimmen, ob ein Dateiname an eine 16-Bit-Windows-basierte Anwendung oder eine MS-DOS-basierte Anwendung übergeben werden kann.

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)	Siehe Anmerkungen
SMB 3.0 mit Skalierungsdateifreigaben (SO)	Siehe Anmerkungen
Freigegebenes Clustervolumedateisystem (CsvFS)	Ja
Resilient File System (ReFS)	Ja

Beachten Sie, dass SMB 3.0 keine Kurznamen für Freigaben mit fortlaufender Verfügbarkeitsfunktion unterstützt, sodass die Funktion immer Null (Fehler) zurückgibt.

Anmerkung

Der winbase.h-Header definiert CheckNameLegalDOS8Dot3 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
mindestens unterstützte Client-	Windows Vista, Windows XP mit SP1 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winbase.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

Dateiverwaltungsfunktionen

GetOEMCP-

Freigeben über