Fungsi CheckNameLegalDOS8Dot3A (winbase.h)

Menentukan apakah nama yang ditentukan dapat digunakan untuk membuat file pada sistem file FAT.

Sintaks

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

Parameter

[in] lpName

Nama file, dalam format 8.3.

[out, optional] lpOemName

Penunjuk ke buffer yang menerima string OEM yang sesuai dengan Nama. Parameter ini bisa NULL.

[in] OemNameSize

Ukuran buffer lpOemName , dalam karakter. Jika lpOemName adalah NULL, parameter ini harus 0 (nol).

[out, optional] pbNameContainsSpaces

Menunjukkan apakah nama berisi spasi atau tidak. Parameter ini bisa NULL. Jika nama bukan nama sistem file FAT 8.3 yang valid, parameter ini tidak ditentukan.

[out] pbNameLegal

Jika fungsi berhasil, parameter ini menunjukkan apakah nama file adalah nama file FAT 8.3 yang valid ketika halaman kode OEM saat ini diterapkan ke nama file.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah 0 (nol). Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini dapat digunakan untuk menentukan apakah nama file dapat diteruskan ke aplikasi berbasis Windows 16-bit atau aplikasi berbasis MS-DOS atau tidak.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Lihat keterangan
SMB 3.0 dengan Scale-out File Shares (SO)	Lihat keterangan
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

 

Perhatikan bahwa SMB 3.0 tidak mendukung nama pendek pada berbagi dengan kemampuan ketersediaan berkelanjutan, sehingga fungsi akan selalu mengembalikan nol (gagal).

Catatan

Header winbase.h mendefinisikan CheckNameLegalDOS8Dot3 sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi Manajemen File

GetOEMCP