IDAdminNotifyHandler::Begin method (dsadmin.h)

Metode IDsAdminNotifyHandler::Begin dipanggil ketika peristiwa yang diminta handler pemberitahuan terjadi. Handler pemberitahuan menentukan peristiwa untuk menerima pemberitahuan ketika IDAdminNotifyHandler::Initialize dipanggil.

Sintaks

HRESULT Begin(
  [in]  ULONG       uEvent,
  [in]  IDataObject *pArg1,
  [in]  IDataObject *pArg2,
  [out] ULONG       *puFlags,
  [out] BSTR        *pBstr
);

Parameter

[in] uEvent

Berisi nilai yang menentukan jenis peristiwa yang terjadi. Ini bisa menjadi salah satu nilai berikut.

DSA_NOTIFY_DEL

Objek dihapus.

DSA_NOTIFY_REN

Objek diganti namanya.

DSA_NOTIFY_MOV

Objek dipindahkan ke kontainer lain.

DSA_NOTIFY_PROP

Satu atau beberapa properti objek dimodifikasi.

[in] pArg1

Penunjuk ke antarmuka IDataObject yang mendukung format clipboard CFSTR_DSOBJECTNAMES . Konten objek data akan bervariasi tergantung pada nilai uEvent. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] pArg2

Penunjuk ke antarmuka IDataObject yang mendukung format clipboard CFSTR_DSOBJECTNAMES . Nilai parameter ini dan konten objek data akan bervariasi tergantung pada nilai uEvent. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[out] puFlags

Penunjuk ke nilai ULONG yang menerima sekumpulan bendera yang memodifikasi perilaku penangan pemberitahuan dalam kotak dialog konfirmasi pemberitahuan. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.

DSA_NOTIFY_FLAG_ADDITIONAL_DATA

Jika bendera ini diatur, entri untuk penangan pemberitahuan ini dalam kotak dialog konfirmasi dipilih. Jika bendera ini tidak diatur, entri untuk penangan pemberitahuan ini dalam kotak dialog konfirmasi tidak dipilih.

DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA

Jika bendera ini diatur, entri untuk penangan pemberitahuan ini dalam kotak dialog konfirmasi dinonaktifkan dan pengguna tidak dapat mengubah status pilihan.

[out] pBstr

Penunjuk ke BSTR yang menerima string yang berisi nama dan/atau deskripsi penangan pemberitahuan. String ini ditampilkan dalam kotak dialog konfirmasi. String ini harus dialokasikan dengan memanggil fungsi SysAllocString . Penelepon harus membebaskan string ini ketika tidak lagi diperlukan. Jika parameter ini menerima NULL atau string kosong, penangan pemberitahuan tidak ditambahkan ke kotak dialog konfirmasi dan IDAdminNotifyHandler::Notify tidak dipanggil.

Nilai kembali

Jika metode berhasil, S_OK dikembalikan. Jika metode gagal, nilai HRESULT standar dikembalikan.

Keterangan

Nilai dan konten pArg1 dan pArg2 bervariasi tergantung pada peristiwa yang diproses seperti yang ditunjukkan oleh uEvent. Daftar berikut menjelaskan apa yang akan dimuat pArg1 dan pArg2 untuk setiap jenis peristiwa yang berbeda.

uEvent	pArg1	pArg2
DSA_NOTIFY_DEL	Berisi objek yang dihapus.	Tidak digunakan. Ini akan menjadi NULL.
DSA_NOTIFY_REN	Berisi nama objek sebelumnya.	Berisi nama baru objek.
DSA_NOTIFY_MOV	Berisi kontainer tempat objek dipindahkan.	Berisi kontainer tempat objek dipindahkan.
DSA_NOTIFY_PROP	Berisi objek yang propertinya telah diubah.	Tidak digunakan. Ini akan menjadi NULL.

Persyaratan

Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	dsadmin.h
DLL	DSAdmin.dll

Lihat juga

CFSTR_DSOBJECTNAMES

IDataObject

IDAdminNotifyHandler

IDAdminNotifyHandler::Initialize

SysAllocString