Dos 形式のファイル名を調べて、Dos デバイス名かどうかを判断します。
構文
ULONG RtlIsDosDeviceName_U(
__in PCWSTR DosFileName
)
パラメーター
isProcessorMode
呼び出し元のアプリケーションによって提供されるブール型ポインター。 正常に実行されると、この変数は OS がプロセッサ モードかコントローラー モードかを示します。
戻り値
| 値 | 説明 |
|---|---|
| 0 | 指定された Dos ファイル名は、Dos デバイスの名前ではありません。 |
| > 0 | 指定された Dos ファイル名は Dos デバイスの名前で、戻り値は ULONG です。この場合、上位 16 ビットは入力バッファー内のオフセットであり、dos デバイス名は であり、下位 16 ビットはデバイス名の長さ (省略可能な末尾のコロンを除く) です。 |
解説
有効な Dos デバイス名は次のとおりです。
- LPTn
- COMn
- PRN
- AUX
- NUL
- CON
- CONIN$
- CONOUT$
n が数字の場合。 末尾のコロンが存在する場合は無視されます。
この関数には、インポート ライブラリまたはヘッダー ファイルが関連付けされません。 LoadLibrary 関数と GetProcAddress 関数を使用して呼び出す必要があります。 API は、ntdll.dll からエクスポートされます。
必要条件
| 要件 | 値 |
|---|---|
| [DLL] | ntdll.dll |