Fungsi SHPathPrepareForWriteA (shlobj_core.h)

Memeriksa untuk melihat apakah jalur ada. Ini termasuk melepas 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.

Sintaksis

SHSTDAPI SHPathPrepareForWriteA(
  [in, optional] HWND     hwnd,
  [in, optional] IUnknown *punkEnableModless,
  [in]           LPCSTR   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 berupa UNC atau jalur drive file.

dwFlags

Jenis: DWORD

Bendera yang menentukan opsi perilaku. Parameter ini bisa menjadi kombinasi dari nilai berikut.

SHPPFW_NONE

Jangan buat direktori baru.

SHPPFW_DEFAULT

Default. Jangan meminta pengguna jika direktori perlu dibuat. Ini identik dengan SHPPFW_DIRCREATE. Jangan lulus dengan SHPPFW_ASKDIRCREATE.

SHPPFW_DIRCREATE

Buat direktori tanpa meminta pengguna. Jangan lulus dengan SHPPFW_ASKDIRCREATE.

SHPPFW_ASKDIRCREATE

Minta pengguna sebelum membuat direktori. Jangan lulus 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 tidak 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.

Komentar

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 memasukkan disk akan muncul.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shlobj_core.h (termasuk Shlobj.h, Shlobj_core.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)