Fungsi SHPathPrepareForWriteW (shlobj_core.h)
Memeriksa untuk melihat apakah jalur ada. Ini termasuk memasang kembali drive jaringan yang dipetakan, meminta media yang dapat dikeluarkan untuk dimasukkan kembali, membuat jalur, meminta media diformat, dan menyediakan antarmuka pengguna yang sesuai, jika perlu. Izin baca/tulis untuk media tidak diperiksa.
Sintaks
SHSTDAPI SHPathPrepareForWriteW(
[in, optional] HWND hwnd,
[in, optional] IUnknown *punkEnableModless,
[in] LPCWSTR pszPath,
DWORD dwFlags
);
Parameter
[in, optional] hwnd
Jenis: HWND
Handel ke jendela yang menentukan jendela induk yang akan digunakan untuk jendela antarmuka pengguna apa pun yang harus dibuat. Jika diatur ke NULL, jendela antarmuka pengguna tidak dibuat.
[in, optional] punkEnableModless
Jenis: IUnknown*
Penunjuk ke antarmuka IUnknown yang menentukan objek IOleInPlaceActiveObject yang mengimplementasikan metode EnableModeless .
[in] pszPath
Jenis: LPCTSTR
Penunjuk ke string panjang maksimum yang dihentikan null MAX_PATH yang menentukan jalur yang akan diverifikasi sebagai valid untuk menulis. Ini bisa menjadi jalur UNC atau drive file.
dwFlags
Jenis: DWORD
Bendera yang menentukan opsi perilaku. Parameter ini bisa menjadi kombinasi dari nilai berikut.
SHPPFW_NONE
Jangan membuat direktori baru.
SHPPFW_DEFAULT
Default. Jangan meminta pengguna jika direktori perlu dibuat. Ini identik dengan SHPPFW_DIRCREATE. Jangan lewat dengan SHPPFW_ASKDIRCREATE.
SHPPFW_DIRCREATE
Buat direktori tanpa meminta pengguna. Jangan lewat dengan SHPPFW_ASKDIRCREATE.
SHPPFW_ASKDIRCREATE
Minta pengguna sebelum membuat direktori. Jangan lewat dengan SHPPFW_DIRCREATE.
SHPPFW_IGNOREFILENAME
Item terakhir dalam pszPath adalah nama file, jadi abaikan. Misalnya, jika pszPath="C:\MyDir\MyFile.doc", hanya gunakan "C:\MyDir". Jika pszPath="C:\MyFirDir\MySecDir", hanya gunakan "C:\MyFirDir".
SHPPFW_NOWRITECHECK
Saat ini tidak diimplementasikan.
SHPPFW_MEDIACHECKONLY
Windows XP atau yang lebih baru. Menekan kotak pesan kesalahan "tidak dapat diakses", yang ditampilkan ketika kegagalan selain pembatalan pengguna terjadi, dan hwnd bukan NULL.
Mengembalikan nilai
Jenis: HRESULT
Mengembalikan S_OK jika jalur tersedia, atau kode kesalahan sebaliknya. Perhatikan bahwa nilai pengembalian S_OK tidak berarti bahwa media dapat ditulis; itu hanya berarti bahwa jalur tersedia.
Keterangan
Penggunaan utama fungsi ini adalah agar program memeriksa jalur sebelum menggunakannya dan menampilkan antarmuka pengguna yang diperlukan untuk meminta pengguna. Misalnya, jika disk di drive A: hilang, jendela yang meminta pengguna untuk menyisipkan disk akan muncul.
Catatan
Header shlobj_core.h mendefinisikan SHPathPrepareForWrite sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [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) |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk