CheckNameLegalDOS8Dot3A-Funktion (winbase.h)

Artikel
03/03/2024

Bestimmt, ob der angegebene Name zum Erstellen einer Datei auf 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 Name entspricht. Dieser Parameter kann NULL sein.

[in] OemNameSize

Die Größe des puffers lpOemName in Zeichen. Wenn lpOemNameNULL 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-Codepage auf den Dateinamen angewendet wird.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Mit dieser Funktion kann ermittelt werden, ob ein Dateiname an eine 16-Bit-Windows-basierte Anwendung oder eine MS-DOS-basierte Anwendung übergeben werden kann.

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

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	Siehe Hinweise
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Siehe Hinweise
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Beachten Sie, dass SMB 3.0 keine kurzen Namen für Freigaben mit kontinuierlicher Verfügbarkeit unterstützt, sodass die Funktion immer null (fehler) zurückgibt.

Hinweis

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 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 Vista, Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Dateiverwaltungsfunktionen

GetOEMCP

Freigeben über