CheckNameLegalDOS8Dot3W-Funktion (winbase.h)

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

Syntax

BOOL CheckNameLegalDOS8Dot3W(
  [in]            LPCWSTR 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.

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.

Anforderungen

Siehe auch

Dateiverwaltungsfunktionen

GetOEMCP-