Pesan SHAREVISTRING

[Dimulai dengan Windows Vista, kotak dialog Buka dan Simpan Sebagai umum telah digantikan oleh Dialog Item Umum. Kami menyarankan agar Anda menggunakan API Dialog Item Umum alih-alih kotak dialog ini dari Pustaka Kotak Dialog Umum.]

Kotak dialog Buka atau Simpan Sebagai mengirimkan pesan terdaftar SHAREVISTRING ke prosedur hook Anda, OFNHookProc, jika pelanggaran berbagi terjadi untuk file yang dipilih saat pengguna mengklik tombol OK .

#define SHAREVISTRING TEXT("commdlg_ShareViolation")

Parameter

wParam

Parameter ini tidak digunakan.

lParam

Penunjuk ke struktur OPENFILENAME . Anggota lpstrFile dari struktur ini berisi nama file yang menyebabkan pelanggaran berbagi.

Menampilkan nilai

Prosedur kait harus mengembalikan salah satu nilai berikut untuk menunjukkan bagaimana kotak dialog harus menangani pelanggaran berbagi.

Mengembalikan kode/nilai	Deskripsi
OFN_SHAREFALLTHROUGH 2	Terima nama file
OFN_SHARENOWARN 1	Tolak nama file tetapi jangan peringatkan pengguna. Aplikasi bertanggung jawab untuk menampilkan pesan peringatan.
OFN_SHAREWARN 0	Tolak nama file dan tampilkan pesan peringatan (hasil yang sama seolah-olah tidak ada prosedur kait).

Keterangan

Prosedur hook harus menentukan konstanta SHAREVISTRING dalam panggilan ke fungsi RegisterWindowMessage untuk mendapatkan pengidentifikasi untuk pesan yang dikirim oleh kotak dialog.

Kotak dialog mengirimkan pesan terdaftar SHAREVISTRING hanya jika Anda tidak menentukan bendera OFN_SHAREAWARE di anggota Bendera struktur OPENFILENAME saat Anda membuat dialog.

Jika prosedur hook mengembalikan nilai yang tidak terdefinisi, kotak dialog merespons seolah-olah OFN_SHAREWARN dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Commdlg.h (sertakan Windows.h)
Nama Unicode dan ANSI	SHAREVISTRINGW (Unicode) dan SHAREVISTRINGA (ANSI)

Lihat juga

Referensi

CDN_SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

Konseptual

Pustaka Kotak Dialog Umum