Share via

Fungsi SHCreateDirectoryExA (shlobj_core.h)

  • Artikel

[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
ERROR_BAD_PATHNAME
 Parameter pszPath diatur ke jalur relatif.
ERROR_FILENAME_EXCED_RANGE
 Jalur yang ditujukkan oleh pszPath terlalu panjang.
ERROR_PATH_NOT_FOUND
 Sistem tidak dapat menemukan jalur yang ditujukan oleh pszPath. Jalur mungkin berisi entri yang tidak valid.
ERROR_FILE_EXISTS
 Direktori ada.
ERROR_ALREADY_EXISTS
 Direktori ada.
ERROR_CANCELLED
 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)

Lihat juga

SHCreateDirectory