RtlIsNameLegalDOS8Dot3 Funktion (ntifs.h)
Die RtlIsNameLegalDOS8Dot3 Routine bestimmt, ob ein bestimmter 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
Zeigen Sie 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 bei Nameentspricht.
[out, optional] NameContainsSpaces
Zeiger auf einen optionalen BOOLESCHEN Wert, der TRUE empfängt, wenn die Zeichenfolge bei Name eingebettete Leerzeichen enthält, FALSE andernfalls. Dieser Wert ist nur gültig, wenn RtlIsNameLegalDOS8Dot3TRUEzurückgibt.
Rückgabewert
RtlIsNameLegalDOS8Dot3 gibt TRUE zurück, wenn die Zeichenfolge bei Name ein gesetzlicher Kurzdateiname (8,3) ist, FALSE andernfalls.
Bemerkungen
RtlIsNameLegalDOS8Dot3 übersetzt die Unicode-Zeichenfolge unter Name mithilfe der OEM-Codeseite, die zur Systemstartzeit als aktuelle Systemcodeseite installiert wurde, und konvertiert die übersetzte Zeichenfolge in Großbuchstaben. (Wenn der Aufrufer einen Puffer bei 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 zulässige Zeichen enthält.
Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Run-Time Library (RTL)-Routinen.
Wenn der Speicherblock bei Name nicht auspaget ist, kann der Aufrufer unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Andernfalls müssen Anrufer von RtlIsNameLegalDOS8Dot3 bei IRQL-< DISPATCH_LEVEL ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Siehe Abschnitt "Hinweise". |