CheckNameLegalDOS8Dot3A 関数 (winbase.h)

指定した名前を使用して FAT ファイル システム上にファイルを作成できるかどうかを判断します。

構文

BOOL CheckNameLegalDOS8Dot3A(
  [in]            LPCSTR lpName,
  [out, optional] LPSTR  lpOemName,
  [in]            DWORD  OemNameSize,
  [out, optional] PBOOL  pbNameContainsSpaces,
  [out]           PBOOL  pbNameLegal
);

パラメーター

[in] lpName

8.3 形式のファイル名。

[out, optional] lpOemName

名前に対応する OEM 文字列を受け取るバッファーへのポインター。 このパラメーターは NULLできます。

[in] OemNameSize

lpOemName バッファーのサイズ (文字数)。 lpOemName が NULL場合、このパラメーターは 0 (ゼロ) にする必要があります。

[out, optional] pbNameContainsSpaces

名前にスペースが含まれているかどうかを示します。 このパラメーターは NULLできます。 名前が有効な 8.3 FAT ファイル システム名でない場合、このパラメーターは未定義です。

[out] pbNameLegal

関数が成功した場合、このパラメーターは、現在の OEM コード ページがファイル名に適用されるときに、ファイル名が有効な 8.3 FAT ファイル名であるかどうかを示します。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 (ゼロ) です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

この関数を使用して、ファイル名を 16 ビット Windows ベースのアプリケーションまたは MS-DOS ベースのアプリケーションに渡すことができるかどうかを判断できます。

Windows 8 および Windows Server 2012 では、この関数は次のテクノロジでサポートされています。

テクノロジー	サポート
サーバー メッセージ ブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 透過的フェールオーバー (TFO)	解説を参照する
SMB 3.0 とスケールアウト ファイル共有 (SO)	解説を参照する
クラスター共有ボリューム ファイル システム (CsvFS)	はい
回復性のあるファイル システム (ReFS)	はい

 

SMB 3.0 では、連続可用性機能を持つ共有の短い名前はサポートされていないため、関数は常にゼロを返します (失敗)。

手記

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CheckNameLegalDOS8Dot3 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista、WINDOWS XP SP1 [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winbase.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

関連項目

ファイル管理機能の

GetOEMCP の