Fungsi SHCreateDirectoryExA (shlobj_core.h)
[Fungsi ini tersedia melalui Windows XP Service Pack 2 (SP2) dan Windows Server 2003. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]
Membuat folder sistem file baru, dengan atribut keamanan opsional.
Sintaks
int SHCreateDirectoryExA(
[in, optional] HWND hwnd,
[in] LPCSTR pszPath,
[in, optional] const SECURITY_ATTRIBUTES *psa
);
Parameter
[in, optional] hwnd
Jenis: HWND
Handel ke jendela induk. Parameter ini dapat diatur ke NULL jika tidak ada antarmuka pengguna yang akan ditampilkan.
[in] pszPath
Jenis: LPCTSTR
Penunjuk ke string yang dihentikan null yang menentukan jalur direktori yang sepenuhnya memenuhi syarat. String ini memiliki panjang maksimum 248 karakter, termasuk karakter null yang mengakhiri.
[in, optional] psa
Jenis: const SECURITY_ATTRIBUTES*
Penunjuk ke struktur SECURITY_ATTRIBUTES dengan atribut keamanan direktori. Atur parameter ini ke NULL jika tidak ada atribut keamanan yang perlu diatur.
Nilai kembali
Jenis: int
Mengembalikan ERROR_SUCCESS jika berhasil. Jika operasi gagal, kode kesalahan lainnya dapat dikembalikan, termasuk yang tercantum di sini. Untuk nilai yang tidak dicantumkan secara khusus, lihat Kode Kesalahan Sistem.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter pszPath diatur ke jalur relatif. |
|
Jalur yang ditujukkan oleh pszPath terlalu panjang. |
|
Sistem tidak dapat menemukan jalur yang ditujukan oleh pszPath. Jalur mungkin berisi entri yang tidak valid. |
|
Direktori ada. |
|
Direktori ada. |
|
Pengguna membatalkan operasi. |
Keterangan
Fungsi ini membuat folder sistem file yang jalurnya sepenuhnya memenuhi syarat diberikan oleh pszPath. Jika satu atau beberapa folder perantara tidak ada, folder tersebut juga dibuat. SHCreateDirectoryEx juga memverifikasi bahwa file terlihat. Jika tidak terlihat, harapkan salah satu hal berikut ini:
- Jika hwnd diatur ke handel jendela yang valid, kotak pesan ditampilkan memperingatkan pengguna bahwa dia mungkin tidak dapat mengakses file. Jika pengguna memilih untuk tidak melanjutkan, fungsi akan mengembalikan ERROR_CANCELLED.
- Jika hwnd diatur ke NULL, tidak ada antarmuka pengguna yang ditampilkan dan fungsi mengembalikan ERROR_CANCELLED.
Catatan
Header shlobj_core.h mendefinisikan SHCreateDirectoryEx 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 2000 Professional, Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | shlobj_core.h (termasuk Shlobj.h, Shlobj_core.h) |
Pustaka | Shell32.lib |
DLL | Shell32.dll (versi 5.0 atau yang lebih baru) |