Bagikan melalui

Fungsi SHCreateDirectory (shlobj_core.h)

  • Artikel

[SHCreateDirectory tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Membuat folder sistem file baru.

Sintaks

int SHCreateDirectory(
  [in, optional] HWND   hwnd,
  [in]           PCWSTR pszPath
);

Parameter

[in, optional] hwnd

Jenis: HWND

Handel ke jendela induk. Parameter ini dapat diatur ke NULL jika tidak ada antarmuka pengguna yang ditampilkan.

[in] pszPath

Jenis: PCWSTR

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur direktori yang sepenuhnya memenuhi syarat. String ini seharusnya tidak lebih dari MAX_PATH karakter, termasuk karakter null yang mengakhiri.

Menampilkan nilai

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_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 membuatnya.

Untuk mengatur atribut keamanan pada folder baru, gunakan SHCreateDirectoryEx.

Persyaratan

   
Klien minimum yang didukung 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)
Pustaka Shell32.lib
DLL Shell32.dll (versi 5.0 atau yang lebih baru)

Lihat juga

SHCreateDirectoryEx