RtlIsNameLegalDOS8Dot3-Funktion (ntifs.h)

Die RtlIsNameLegalDOS8Dot3-Routine bestimmt, ob ein gegebener Name einen gültigen kurzen Dateinamen (8.3) darstellt.

Syntax

NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
  [in]            PCUNICODE_STRING Name,
  [in, out]       POEM_STRING      OemName,
  [out, optional] PBOOLEAN         NameContainsSpaces
);

Parameter

[in] Name

Zeiger auf eine Unicode-Zeichenfolge, die den Dateinamen enthält.

[in, out] OemName

Zeiger auf einen optionalen vom Aufrufer zugewiesenen Puffer, der eine gezählte OEM-Zeichenfolge empfängt, die der Unicode-Zeichenfolge unter Name entspricht.

[out, optional] NameContainsSpaces

Zeiger auf einen optionalen BOOLESCHEN Wert, der TRUE empfängt, wenn die Zeichenfolge unter Name eingebettete Leerzeichen enthält, andernfalls FALSE . Dieser Wert ist nur gültig, wenn RtlIsNameLegalDOS8Dot3TRUE zurückgibt.

Rückgabewert

RtlIsNameLegalDOS8Dot3 gibt TRUE zurück, wenn die Zeichenfolge unter Name ein juristischer Kurzdateiname (8.3) ist, andernfalls FALSE .

Hinweise

RtlIsNameLegalDOS8Dot3 übersetzt die Unicode-Zeichenfolge unter Name mithilfe der OEM-Codepage, die zur Systemstartzeit als aktuelle Systemcodepage installiert wurde, und konvertiert die übersetzte Zeichenfolge in Großbuchstaben. (Wenn der Aufrufer einen Puffer unter OemName bereitgestellt hat, empfängt dieser Puffer die resultierende Zeichenfolge.) RtlIsNameLegalDOS8Dot3 überprüft, ob der Name ein ordnungsgemäß formatierter 8.3-Name ist und nur rechtliche Zeichen enthält.

Informationen zu anderen Zeichenfolgenverarbeitungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).

Wenn der Speicherblock unter Name nicht aus der Seite ist, kann der Aufrufer unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Andernfalls müssen Aufrufer von RtlIsNameLegalDOS8Dot3 im IRQL-DISPATCH_LEVEL < ausgeführt werden.

Anforderungen

Weitere Informationen

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING