Fungsi CreateFileW (fileapi.h)
Membuat atau membuka file atau perangkat I/O. Perangkat I/O yang paling umum digunakan adalah sebagai berikut: file, aliran file, direktori, disk fisik, volume, buffer konsol, tape drive, sumber daya komunikasi, mailslot, dan pipa. Fungsi mengembalikan handel yang dapat digunakan untuk mengakses file atau perangkat untuk berbagai jenis I/O tergantung pada file atau perangkat dan bendera dan atribut yang ditentukan.
Untuk melakukan operasi ini sebagai operasi yang ditransaksikan, yang menghasilkan handel yang dapat digunakan untuk I/O yang ditransaksikan, gunakan fungsi
Sintaksis
HANDLE CreateFileW(
[in] LPCWSTR lpFileName,
[in] DWORD dwDesiredAccess,
[in] DWORD dwShareMode,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[in] DWORD dwCreationDisposition,
[in] DWORD dwFlagsAndAttributes,
[in, optional] HANDLE hTemplateFile
);
Parameter
[in] lpFileName
Nama file atau perangkat yang akan dibuat atau dibuka. Anda dapat menggunakan garis miring (/) atau garis miring terbelakang (\) dalam nama ini.
Untuk informasi tentang nama perangkat khusus, lihat Menentukan Nama Perangkat MS-DOS.
Untuk membuat aliran file, tentukan nama file, titik dua, lalu nama aliran. Untuk informasi selengkapnya, lihat Aliran File.
Secara default, nama dibatasi untuk MAX_PATH karakter. Untuk memperpanjang batas ini menjadi 32.767 karakter lebar, tambahkan awal "\\?\" ke jalur. Untuk informasi selengkapnya, lihat Penamaan File, Jalur, dan Namespace.
Ujung
Dimulai dengan Windows 10, Versi 1607, Anda dapat memilih untuk menghapus batasan MAX_PATH tanpa prepending "\\?\". Lihat bagian "Batasan Panjang Jalur Maksimum" Penamaan File, Jalur, dan Namespace untuk detailnya.
[in] dwDesiredAccess
Akses yang diminta ke file atau perangkat, yang dapat diringkas sebagai baca, tulis, keduanya atau bukan nol).
Nilai yang paling umum digunakan adalah GENERIC_READ, GENERIC_WRITE, atau keduanya (GENERIC_READ | GENERIC_WRITE). Untuk informasi selengkapnya, lihat Hak Akses Generik, Keamanan File dan Hak Akses, Konstanta Hak Akses File, dan ACCESS_MASK.
Jika parameter ini nol, aplikasi dapat meminta metadata tertentu seperti atribut file, direktori, atau perangkat tanpa mengakses file atau perangkat tersebut, bahkan jika akses GENERIC_READ akan ditolak.
Anda tidak dapat meminta mode akses yang bertentangan dengan mode berbagi yang ditentukan oleh parameter dwShareMode dalam permintaan terbuka yang sudah memiliki handel terbuka.
Untuk informasi selengkapnya, lihat bagian Keterangan topik ini dan Membuat dan Membuka File.
[in] dwShareMode
Mode berbagi file atau perangkat yang diminta, yang dapat dibaca, ditulis, keduanya, hapus, semua ini, atau tidak ada (lihat tabel berikut). Permintaan akses ke atribut atau atribut yang diperluas tidak terpengaruh oleh bendera ini.
Jika parameter ini nol dan CreateFile berhasil, file atau perangkat tidak dapat dibagikan dan tidak dapat dibuka lagi sampai handel ke file atau perangkat ditutup. Untuk informasi selengkapnya, lihat bagian Keterangan.
Anda tidak dapat meminta mode berbagi yang bertentangan dengan mode akses yang ditentukan dalam permintaan yang ada yang memiliki handel terbuka. createFile akan gagal dan fungsi GetLastError akan mengembalikan ERROR_SHARING_VIOLATION.
Untuk mengaktifkan proses berbagi file atau perangkat saat proses lain membuka file atau perangkat, gunakan kombinasi yang kompatibel dari satu atau beberapa nilai berikut. Untuk informasi selengkapnya tentang kombinasi parameter ini yang valid dengan parameter
[in, optional] lpSecurityAttributes
Penunjuk ke struktur SECURITY_ATTRIBUTES yang berisi dua anggota data terpisah tetapi terkait: deskriptor keamanan opsional, dan nilai Boolean yang menentukan apakah handel yang dikembalikan dapat diwariskan oleh proses turunan.
Parameter ini dapat null.
Jika parameter ini NULL, handel yang dikembalikan oleh CreateFile tidak dapat diwariskan oleh proses turunan apa pun yang dapat dibuat aplikasi dan file atau perangkat yang terkait dengan handel yang dikembalikan mendapatkan pendeskripsi keamanan default.
lpSecurityDescriptor anggota struktur menentukan SECURITY_DESCRIPTOR untuk file atau perangkat. Jika anggota ini NULL, file atau perangkat yang terkait dengan handel yang dikembalikan diberi pendeskripsi keamanan default.
bInheritHandle anggota struktur menentukan apakah handel yang dikembalikan dapat diwariskan.
Untuk informasi selengkapnya, lihat bagian Keterangan.
[in] dwCreationDisposition
Tindakan yang harus diambil pada file atau perangkat yang ada atau tidak ada.
Untuk perangkat selain file, parameter ini biasanya diatur ke OPEN_EXISTING.
Untuk informasi selengkapnya, lihat bagian Keterangan.
Parameter ini harus merupakan salah satu nilai berikut, yang tidak dapat digabungkan:
[in] dwFlagsAndAttributes
Atribut dan bendera file atau perangkat, FILE_ATTRIBUTE_NORMAL menjadi nilai default yang paling umum untuk file.
Parameter ini dapat mencakup kombinasi atribut file yang tersedia (FILE_ATTRIBUTE_*). Semua atribut file lainnya mengambil alih FILE_ATTRIBUTE_NORMAL.
Parameter ini juga dapat berisi kombinasi bendera (FILE_FLAG_) untuk kontrol perilaku penembolokan file atau perangkat, mode akses, dan bendera tujuan khusus lainnya. Ini dikombinasikan dengan nilai FILE_ATTRIBUTE_ apa pun.
Parameter ini juga dapat berisi informasi Kualitas Layanan Keamanan (SQOS) dengan menentukan bendera SECURITY_SQOS_PRESENT. Informasi bendera terkait SQOS tambahan disajikan dalam tabel dengan mengikuti atribut dan tabel bendera.
Untuk akses lebih lanjut ke atribut file, lihat SetFileAttributes. Untuk daftar lengkap semua atribut file dengan nilai dan deskripsinya, lihat Konstanta Atribut File.
| Bendera | Arti |
|---|---|
|
File sedang dibuka atau dibuat untuk operasi pencadangan atau pemulihan. Sistem memastikan bahwa proses panggilan mengambil alih pemeriksaan keamanan file ketika proses memiliki hak istimewa SE_BACKUP_NAME dan SE_RESTORE_NAME. Untuk informasi selengkapnya, lihat Mengubah Hak Istimewa dalam token.
Anda harus mengatur bendera ini untuk mendapatkan handel ke direktori. Handel direktori dapat diteruskan ke beberapa fungsi alih-alih handel file. Untuk informasi selengkapnya, lihat bagian Keterangan. |
|
File akan dihapus segera setelah semua handelnya ditutup, yang mencakup handel yang ditentukan dan handel terbuka atau duplikat lainnya.
Jika ada handel terbuka yang ada ke file, panggilan gagal kecuali semuanya dibuka dengan mode berbagi FILE_SHARE_DELETE. Permintaan terbuka berikutnya untuk file tersebut akan gagal, kecuali mode berbagi FILE_SHARE_DELETE ditentukan. |
|
File atau perangkat sedang dibuka tanpa penembolokan sistem untuk pembacaan dan penulisan data. Bendera ini tidak memengaruhi penembolokan hard disk atau file yang dipetakan memori.
Ada persyaratan ketat untuk berhasil bekerja dengan file yang dibuka dengan CreateFile menggunakan bendera FILE_FLAG_NO_BUFFERING, untuk detailnya lihat File Buffering. |
|
Data file diminta, tetapi harus terus berada di penyimpanan jarak jauh. Ini tidak boleh diangkut kembali ke penyimpanan lokal. Bendera ini untuk digunakan oleh sistem penyimpanan jarak jauh. |
|
Pemrosesan titik pemisahan ulang Bendera ini tidak dapat digunakan dengan bendera CREATE_ALWAYS. Jika file bukan titik pemisahan ulang, maka bendera ini diabaikan. Untuk informasi selengkapnya, lihat bagian Keterangan. |
|
File atau perangkat sedang dibuka atau dibuat untuk I/O asinkron.
Ketika operasi I/O berikutnya selesai pada handel ini, peristiwa yang ditentukan dalam struktur Jika bendera ini ditentukan, file dapat digunakan untuk operasi baca dan tulis bersamaan. Jika bendera ini tidak ditentukan, maka operasi I/O diserialisasikan, bahkan jika panggilan ke fungsi baca dan tulis menentukan struktur TUMPANG TINDIH. Untuk informasi tentang pertimbangan saat menggunakan handel file yang dibuat dengan bendera ini, lihat bagian Handle I/O Sinkron dan Asinkron topik ini. |
|
Akses akan terjadi sesuai dengan aturan POSIX. Ini termasuk mengizinkan beberapa file dengan nama, hanya berbeda jika, untuk sistem file yang mendukung penamaan tersebut. Gunakan hati-hati saat menggunakan opsi ini, karena file yang dibuat dengan bendera ini mungkin tidak dapat diakses oleh aplikasi yang ditulis untuk MS-DOS atau Windows 16-bit. |
|
Akses dimaksudkan untuk acak. Sistem dapat menggunakan ini sebagai petunjuk untuk mengoptimalkan penembolokan file.
Bendera ini tidak berpengaruh jika sistem file tidak mendukung I/O cache dan FILE_FLAG_NO_BUFFERING. Untuk informasi selengkapnya, lihat bagian Perilaku Penembolokan |
|
File atau perangkat sedang dibuka dengan kesadaran sesi. Jika bendera ini tidak ditentukan, maka perangkat per sesi (seperti perangkat yang menggunakan Pengalihan USB RemoteFX) tidak dapat dibuka oleh proses yang berjalan di sesi 0.
Bendera ini tidak berpengaruh bagi penelepon yang tidak berada di sesi 0. Bendera ini hanya didukung pada Windows edisi server.
Windows Server 2008 R2 dan Windows Server 2008: Bendera ini tidak didukung sebelum Windows Server 2012. |
|
Akses dimaksudkan untuk berurutan dari awal hingga akhir. Sistem dapat menggunakan ini sebagai petunjuk untuk mengoptimalkan penembolokan file.
Bendera ini tidak boleh digunakan jika read-behind (yaitu, pemindaian terbalik) akan digunakan. Bendera ini tidak berpengaruh jika sistem file tidak mendukung I/O cache dan FILE_FLAG_NO_BUFFERING. Untuk informasi selengkapnya, lihat bagian Perilaku Penembolokan |
|
Operasi tulis tidak akan melalui cache perantara apa pun, mereka akan langsung masuk ke disk.
Untuk informasi tambahan, lihat bagian Perilaku Penembolokan |
Parameter
[in, optional] hTemplateFile
Handel yang valid ke file templat dengan hak akses GENERIC_READ. File templat menyediakan atribut file dan atribut yang diperluas untuk file yang sedang dibuat.
Parameter ini dapat null.
Saat membuka file yang ada, CreateFile mengabaikan parameter ini.
Saat membuka file terenkripsi baru, file mewarisi daftar kontrol akses diskresi dari direktori induknya. Untuk informasi tambahan, lihat Enkripsi File.
Mengembalikan nilai
Jika fungsi berhasil, nilai pengembalian adalah handel terbuka ke file, perangkat, pipa bernama, atau slot email yang ditentukan.
Jika fungsi gagal, nilai yang dikembalikan adalah INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.
Komentar
CreateFile awalnya dikembangkan khusus untuk interaksi file tetapi sejak itu telah diperluas dan ditingkatkan untuk menyertakan sebagian besar jenis perangkat dan mekanisme I/O lainnya yang tersedia untuk pengembang Windows. Bagian ini mencoba untuk mencakup berbagai masalah yang mungkin dialami pengembang saat menggunakan CreateFile dalam konteks yang berbeda dan dengan jenis I/O yang berbeda. Teks mencoba menggunakan kata file hanya ketika merujuk khusus ke data yang disimpan dalam file aktual pada sistem file. Namun, beberapa penggunaan file mungkin merujuk lebih umum ke objek I/O yang mendukung mekanisme seperti file. Penggunaan liberal istilah ini file sangat lazim dalam nama konstanta dan nama parameter karena alasan historis yang disebutkan sebelumnya.
Ketika aplikasi selesai menggunakan handel objek yang dikembalikan oleh
Beberapa sistem file, seperti sistem file NTFS, mendukung kompresi atau enkripsi untuk file dan direktori individual. Pada volume yang memiliki sistem file yang dipasang dengan dukungan ini, file baru mewarisi atribut kompresi dan enkripsi direktorinya.
Anda tidak dapat menggunakan
Windows Server 2003 dan Windows XP: Untuk tujuan kompatibilitas mundur, CreateFile tidak menerapkan aturan pewarisan saat Anda menentukan deskriptor keamanan di lpSecurityAttributes. Untuk mendukung pewarisan, fungsi yang nantinya mengkueri deskriptor keamanan file ini dapat menentukan dan melaporkan bahwa pewarisan berlaku secara heuristik. Untuk informasi selengkapnya, lihat Penyebaran Otomatis ACE yang Dapat Diwariskan.
Seperti yang dinyatakan sebelumnya, jika parameter lpSecurityAttributesNULL, handel yang dikembalikan oleh CreateFile tidak dapat diwariskan oleh proses anak apa pun yang mungkin dibuat aplikasi Anda. Informasi berikut mengenai parameter ini juga berlaku:
- Jika variabel anggota bInheritHandle tidak FALSE, yang merupakan nilai bukan nol, maka handel dapat diwariskan. Oleh karena itu sangat penting anggota struktur ini diinisialisasi dengan benar untuk FALSE jika Anda tidak berniat menangani untuk diwariskan.
- Daftar kontrol akses (ACL) dalam deskriptor keamanan default untuk file atau direktori diwarisi dari direktori induknya.
- Sistem file target harus mendukung keamanan pada file dan direktori untuk lpSecurityDescriptor anggota untuk memiliki efek pada mereka, yang dapat ditentukan dengan menggunakan GetVolumeInformation.
| Teknologi | Didukung |
|---|---|
| Protokol Server Message Block (SMB) 3.0 | Ya |
| Failover Transparan (TFO) SMB 3.0 | Lihat komentar |
| SMB 3.0 dengan Scale-out File Shares (SO) | Lihat komentar |
| Sistem File Volume Bersama Kluster (CsvFS) | Ya |
| Sistem File Tangguh (ReFS) | Ya |
Perhatikan bahwa createFile dengan disposisi supersede akan gagal jika dilakukan pada file di mana sudah ada aliran data alternatif yang terbuka.
Perilaku Tautan Simbolis
Jika panggilan ke fungsi ini membuat file, tidak ada perubahan perilaku. Selain itu, pertimbangkan informasi berikut mengenai FILE_FLAG_OPEN_REPARSE_POINT:-
Jika FILE_FLAG_OPEN_REPARSE_POINT ditentukan:
- Jika file yang ada dibuka dan merupakan tautan simbolis, handel yang dikembalikan adalah handel ke tautan simbolis.
- Jika TRUNCATE_EXISTING atau FILE_FLAG_DELETE_ON_CLOSE ditentukan, file yang terpengaruh adalah tautan simbolis.
-
Jika FILE_FLAG_OPEN_REPARSE_POINT tidak ditentukan:
- Jika file yang ada dibuka dan merupakan tautan simbolis, handel yang dikembalikan adalah handel ke target.
- Jika CREATE_ALWAYS, TRUNCATE_EXISTING, atau FILE_FLAG_DELETE_ON_CLOSE ditentukan, file yang terpengaruh adalah target.
Perilaku penembolokan
Beberapa nilai yang mungkin untuk parameter- FILE_FLAG_NO_BUFFERING
- FILE_FLAG_RANDOM_ACCESS
- FILE_FLAG_SEQUENTIAL_SCAN
- FILE_FLAG_WRITE_THROUGH
- FILE_ATTRIBUTE_TEMPORARY
Beberapa bendera ini tidak boleh digabungkan. Misalnya, menggabungkan FILE_FLAG_RANDOM_ACCESS dengan FILE_FLAG_SEQUENTIAL_SCAN adalah mengalahkan diri sendiri.
Menentukan bendera FILE_FLAG_SEQUENTIAL_SCAN dapat meningkatkan performa untuk aplikasi yang membaca file besar menggunakan akses berurutan. Perolehan performa bisa lebih terlihat untuk aplikasi yang membaca file besar sebagian besar secara berurutan, tetapi kadang-kadang melewati rentang kecil byte. Jika aplikasi memindahkan penunjuk file untuk akses acak, performa penembolokan optimal kemungkinan besar tidak akan terjadi. Namun, operasi yang benar masih dijamin.
Bendera FILE_FLAG_WRITE_THROUGH dan FILE_FLAG_NO_BUFFERING independen dan dapat digabungkan.
Jika FILE_FLAG_WRITE_THROUGH digunakan tetapi FILE_FLAG_NO_BUFFERING tidak juga ditentukan, sehingga penembolokan sistem berlaku, maka data ditulis ke cache sistem tetapi dihapus ke disk tanpa penundaan.
Jika FILE_FLAG_WRITE_THROUGH dan FILE_FLAG_NO_BUFFERING ditentukan, sehingga penembolokan sistem tidak berlaku, maka data segera dihapus ke disk tanpa melalui cache sistem Windows. Sistem operasi juga meminta write-through dari cache perangkat keras lokal hard disk ke media persisten.
Permintaan write-through melalui FILE_FLAG_WRITE_THROUGH juga menyebabkan NTFS menghapus perubahan metadata apa pun, seperti pembaruan stempel waktu atau operasi penggantian nama, yang dihasilkan dari pemrosesan permintaan. Untuk alasan ini, bendera FILE_FLAG_WRITE_THROUGH sering digunakan dengan bendera FILE_FLAG_NO_BUFFERING sebagai pengganti untuk memanggil FlushFileBuffers fungsi setelah setiap penulisan, yang dapat menyebabkan penalti performa yang tidak perlu. Menggunakan bendera ini bersama-sama menghindari penalti tersebut. Untuk informasi umum tentang penembolokan file dan metadata, lihat Penembolokan File.
Ketika FILE_FLAG_NO_BUFFERING dikombinasikan dengan FILE_FLAG_OVERLAPPED, bendera memberikan performa asinkron maksimum, karena I/O tidak bergantung pada operasi sinkron manajer memori. Namun, beberapa operasi I/O membutuhkan lebih banyak waktu, karena data tidak disimpan di cache. Selain itu, metadata file mungkin masih di-cache (misalnya, saat membuat file kosong). Untuk memastikan bahwa metadata dibersihkan ke disk, gunakan fungsi
Menentukan atribut FILE_ATTRIBUTE_TEMPORARY menyebabkan sistem file menghindari penulisan data kembali ke penyimpanan massal jika memori cache yang memadai tersedia, karena aplikasi menghapus file sementara setelah handel ditutup. Dalam hal ini, sistem sepenuhnya dapat menghindari penulisan data. Meskipun tidak secara langsung mengontrol penembolokan data dengan cara yang sama seperti bendera yang disebutkan sebelumnya, atribut FILE_ATTRIBUTE_TEMPORARY memang memberi tahu sistem untuk menahan sebanyak mungkin dalam cache sistem tanpa menulis dan oleh karena itu mungkin menjadi perhatian untuk aplikasi tertentu.
File
Jika Anda mengganti nama atau menghapus file lalu memulihkannya segera setelahnya, sistem mencari cache untuk informasi file yang akan dipulihkan. Informasi cache mencakup pasangan nama pendek/panjang dan waktu pembuatannya.Jika Anda memanggil
Parameter
Jika CREATE_ALWAYS dan FILE_ATTRIBUTE_NORMAL ditentukan, CreateFile gagal dan mengatur kesalahan terakhir ke ERROR_ACCESS_DENIED jika file ada dan memiliki atribut FILE_ATTRIBUTE_HIDDEN atau FILE_ATTRIBUTE_SYSTEM. Untuk menghindari kesalahan, tentukan atribut yang sama dengan file yang ada.
Ketika aplikasi membuat file di seluruh jaringan, lebih baik menggunakan
Untuk informasi selengkapnya, lihat Membuat dan Membuka File.
Handel I/O Sinkron dan Asinkron
CreateFile menyediakan untuk membuat handel file atau perangkat yang sinkron atau asinkron. Handel sinkron berperilaku sedemikian rup sehingga panggilan fungsi I/O menggunakan handel tersebut diblokir sampai selesai, sementara handel file asinkron memungkinkan sistem untuk segera kembali dari panggilan fungsi I/O, apakah mereka menyelesaikan operasi I/O atau tidak. Seperti yang dinyatakan sebelumnya, perilaku sinkron versus asinkron ini ditentukan dengan menentukanAliran File
Pada sistem file NTFS, Anda dapat menggunakanDirektori
Aplikasi tidak dapat membuat direktori dengan menggunakan CreateFile, oleh karena itu hanya nilai OPEN_EXISTING yang valid untuk dwCreationDisposition untuk kasus penggunaan ini. Untuk membuat direktori, aplikasi harus memanggil CreateDirectory atau CreateDirectoryEx.Untuk membuka direktori menggunakan CreateFile, tentukan bendera FILE_FLAG_BACKUP_SEMANTICS sebagai bagian dari dwFlagsAndAttributes. Pemeriksaan keamanan yang sesuai masih berlaku ketika bendera ini digunakan tanpa hak istimewa SE_BACKUP_NAME dan SE_RESTORE_NAME.
Saat menggunakan CreateFile untuk membuka direktori selama defragmentasi volume sistem file FAT atau FAT32, jangan tentukan hak akses MAXIMUM_ALLOWED. Akses ke direktori ditolak jika ini dilakukan. Tentukan akses GENERIC_READ tepat sebagai gantinya.
Untuk informasi selengkapnya, lihat Tentang Manajemen Direktori.
Disk fisik dan Volume
Akses langsung ke disk atau ke volume dibatasi.Windows Server 2003 dan Windows XP: Akses langsung ke disk atau ke volume tidak dibatasi dengan cara ini.
Anda dapat menggunakan fungsi
Persyaratan berikut harus dipenuhi agar panggilan tersebut berhasil:
- Pemanggil harus memiliki hak administratif. Untuk informasi selengkapnya, lihat Berjalan dengan Hak Istimewa Khusus.
- Parameter
dwCreationDisposition harus memiliki bendera OPEN_EXISTING . - Saat membuka volume atau disket, parameter
dwShareMode harus memiliki bendera FILE_SHARE_WRITE .
| Tali | Arti |
|---|---|
| "\\.\PhysicalDrive0" | Membuka drive fisik pertama. |
| "\\.\PhysicalDrive2" | Membuka drive fisik ketiga. |
Untuk mendapatkan pengidentifikasi drive fisik untuk volume, buka handel ke volume dan panggil fungsi DeviceIoControl dengan IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS. Kode kontrol ini mengembalikan nomor disk dan offset untuk masing-masing volume satu atau beberapa tingkat; volume dapat mencakup beberapa disk fisik.
Untuk contoh membuka drive fisik, lihat Memanggil DeviceIoControl.
Saat membuka volume atau drive media yang dapat dilepas (misalnya, disk drive floppy atau flash memory thumb drive), string lpFileName
| Tali | Arti |
|---|---|
| "\\.\A:" | Membuka disk disket drive A. |
| "\\.\C:" | Membuka volume C: . |
| "\\.\C:\" | Membuka sistem file volume C: . |
Anda juga dapat membuka volume dengan merujuk ke nama volumenya. Untuk informasi selengkapnya, lihat Penamaan Volume.
Volume berisi satu atau beberapa sistem file yang dipasang. Handel volume dapat dibuka sebagai non-cached atas kebijakan sistem file tertentu, bahkan ketika opsi non-cached tidak ditentukan dalam CreateFile. Anda harus berasumsi bahwa semua sistem file Microsoft membuka handel volume sebagai non-cache. Pembatasan I/O yang tidak di-cache untuk file juga berlaku untuk volume.
Sistem file mungkin atau mungkin tidak memerlukan perataan buffer meskipun data tidak di-cache. Namun, jika opsi non-cache ditentukan saat membuka volume, perataan buffer diberlakukan terlepas dari sistem file pada volume. Disarankan pada semua sistem file yang Anda buka handel volumenya sebagai non-cache, dan ikuti pembatasan I/O yang tidak di-cache.
Perangkat Pengubah
Kode kontrol IOCTL_CHANGER_* untuk DeviceIoControl menerima handel ke perangkat pengubah. Untuk membuka perangkat pengubah, gunakan nama file formulir berikut: "\\.\Changerx" di mana x adalah angka yang menunjukkan perangkat mana yang akan dibuka, dimulai dengan nol. Untuk membuka perangkat pengubah nol dalam aplikasi yang ditulis dalam C atau C++, gunakan nama file berikut: "\\\\.\Changer0".Tape Drive
Anda dapat membuka drive pita dengan menggunakan nama file formulir berikut: "\\.\TAPEx" di mana x adalah angka yang menunjukkan drive mana yang akan dibuka, dimulai dengan nol drive pita. Untuk membuka tape drive nol dalam aplikasi yang ditulis dalam C atau C++, gunakan nama file berikut: "\\\\.\TAPE0".Untuk informasi selengkapnya, lihat Backup.
Sumber Daya Komunikasi
FungsiUntuk menentukan nomor port COM yang lebih besar dari 9, gunakan sintaks berikut: "\.\COM10". Sintaks ini berfungsi untuk semua nomor port dan perangkat keras yang memungkinkan nomor port COM ditentukan.
Untuk informasi selengkapnya tentang komunikasi, lihat Communications.
Konsol
Fungsi| Parameter | Nilai |
|---|---|
| lpFileName |
Gunakan nilai CONIN$ untuk menentukan input konsol.
Gunakan nilai CONOUT$ untuk menentukan output konsol. CONIN$ mendapatkan handel ke buffer input konsol, bahkan jika fungsi setStdHandle CONOUT$ mendapatkan handel ke buffer layar aktif, bahkan jika SetStdHandle mengalihkan handel output standar. Untuk mendapatkan handel output standar, gunakan GetStdHandle. |
| dwDesiredAccess |
GENERIC_READ | GENERIC_WRITE lebih disukai, tetapi salah satu dapat membatasi akses.
|
| dwShareMode |
Saat membuka CONIN$, tentukan FILE_SHARE_READ. Saat membuka CONOUT$, tentukan FILE_SHARE_WRITE.
Jika proses panggilan mewarisi konsol, atau jika proses anak harus dapat mengakses konsol, parameter ini harus |
| lpSecurityAttributes | Jika Anda ingin konsol diwariskan, bInheritHandle anggota struktur SECURITY_ATTRIBUTES harus TRUE. |
| dwCreationDisposition |
Anda harus menentukan |
| dwFlagsAndAttributes | Diabaikan. |
| hTemplateFile | Diabaikan. |
Tabel berikut ini memperlihatkan berbagai pengaturan dwDesiredAccess dan lpFileName.
| lpFileName | dwDesiredAccess | Hasil |
|---|---|---|
| "CON" | GENERIC_READ | Membuka konsol untuk input. |
| "CON" | GENERIC_WRITE | Membuka konsol untuk output. |
| "CON" | GENERIC_READ | GENERIC_WRITE |
Menyebabkan |
Mailslots
Jika CreateFile membuka akhir klien dari mailslot, fungsi mengembalikan INVALID_HANDLE_VALUE jika klien mailslot mencoba membuka mailslot lokal sebelum server mailslot membuatnya dengan fungsi CreateMailSlot.Untuk informasi selengkapnya, lihat Mailslots .
Pipa
Jika CreateFile membuka akhir klien dari pipa bernama, fungsi menggunakan instans pipa bernama apa pun yang berada dalam status mendengarkan. Proses pembukaan dapat menduplikasi handel sebanyak yang diperlukan, tetapi setelah dibuka, instans pipa bernama tidak dapat dibuka oleh klien lain. Akses yang ditentukan ketika pipa dibuka harus kompatibel dengan akses yang ditentukan dalam parameter dwOpenMode fungsi CreateNamedPipe.Jika fungsi
Jika ada setidaknya satu instans pipa aktif tetapi tidak ada pipa pendengar yang tersedia di server, yang berarti semua instans pipa saat ini terhubung, CreateFile gagal dengan ERROR_PIPE_BUSY.
Untuk informasi selengkapnya, lihat Pipes.
Contoh
Contoh operasi file diperlihatkan dalam topik berikut:
- Menambahkan Satu File ke File Lain
- Membatalkan Operasi I/O Yang Tertunda
- Membuat Proses Anak dengan Input dan Output yang Dialihkan
- Membuat dan Menggunakan File Sementara
- FSCTL_RECALL_FILE
- GetFinalPathNameByHandle
- Mengunci dan Membuka Kunci Rentang Byte dalam File
- Mendapatkan Nama File Dari Handel File
- Mendapatkan Informasi Pengenalan Sistem File
- Membuka File untuk Membaca atau Menulis
- Mengambil Waktu Last-Write
- setFileInformationByHandle
- Pengujian untuk Akhir File
- Menggunakan Fiber
- Menggunakan stream
- Berjalan dengan Buffer Perubahan Catatan Jurnal
- Wow64DisableWow64FsRedirection
- Wow64EnableWow64FsRedirection
- Memanggil DeviceIoControl
- Mengonfigurasi Sumber Daya Komunikasi
-
Peristiwa Komunikasi Pemantauan
- Memproses Permintaan untuk Menghapus perangkat
Bekerja dengan mailslot ditampilkan dalam Menulis keMailslot .
Cuplikan kode cadangan pita dapat ditemukan di Membuat Aplikasi Cadangan.
Nota
Header fileapi.h mendefinisikan CreateFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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
| Syarat | Nilai |
|---|---|
| klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Platform Target |
Windows |
| Header |
fileapi.h (termasuk Windows.h) |
| Pustaka |
Kernel32.lib |
| DLL |
Kernel32.dll |
Lihat juga
Tentang Manajemen Direktori
Tentang Manajemen Volume
Pencadangan
Membuat, Menghapus, dan Memelihara File
Kontrol Input dan Output Perangkat (IOCTL)
DeviceIoControl
Enkripsi File
Keamanan File dan Hak Akses
Aliran File
Fungsi
GetLastError
Port Penyelesaian I/O
Konsep I/O
Mendapatkan dan Mengatur Informasi File
Topik Ringkasan
Pipa
ReadFile
ReadFileEx
Berjalan dengan Hak Istimewa khusus
SetFileAttributes
WriteFile