IExtendTaskPad::Metode TaskNotify (mmc.h)

Metode IExtendTaskPad::TaskNotify memungkinkan MMC untuk memberi tahu snap-in saat tugas diperluas. Jika taskpad adalah taskpad tampilan daftar, MMC juga memanggil IExtendTaskPad::TaskNotify saat tombol tampilan daftar diperluas.

Sintaks

HRESULT TaskNotify(
  [in] IDataObject *pdo,
  [in] VARIANT     *arg,
  [in] VARIANT     *param
);

Parameter

[in] pdo

Penunjuk ke objek data untuk item cakupan yang memiliki taskpad. Jika snap-in Anda memiliki item yang menampilkan taskpad, pdo adalah penunjuk ke item tersebut. Jika snap-in Anda memperluas taskpad snap-in lain, pdo adalah penunjuk ke item di snap-in yang memiliki taskpad.

[in] arg

Penunjuk ke struktur VARIAN yang berisi informasi yang diteruskan kembali dari kontrol CIC pada taskpad.

Taskpad menggunakan templat taskpad MMC

Untuk taskpad yang disediakan MMC, struktur VARIAN berisi ID perintah untuk tugas taskpad atau tombol tampilan daftar yang died.

Bidang vt VT_I4 dan bidang lVal berisi ID perintah untuk tugas taskpad atau tombol tampilan daftar yang died. Tombol tampilan daftar hanya berlaku untuk taskpad tampilan daftar.

ID perintah tugas ditentukan dalam anggota nCommandID dari struktur MMC_TASK , yang diteruskan dalam metode IEnumTASK::Metode berikutnya yang dipanggil MMC saat mengambil informasi untuk tugas tersebut selama penyiapan taskpad.

Tombol tampilan daftar adalah tombol yang ditentukan dalam anggota szButtonText dari struktur MMC_LISTPAD_INFO , yang diteruskan dalam metode IExtendTaskPad::GetListPadInfo yang dipanggil MMC saat menyiapkan taskpad tampilan daftar. ID perintah tombol tampilan daftar ditentukan dalam anggota nCommandID MMC_LISTPAD_INFO.

Taskpad menggunakan halaman HTML kustom

Untuk taskpad kustom, struktur VARIAN dapat berisi data apa pun yang ingin diteruskan oleh skrip pada halaman HTML kustom melalui metode TaskNotify objek CIC

[in] param

Penunjuk ke struktur VARIAN yang berisi informasi yang diteruskan kembali dari kontrol CIC pada taskpad.

Taskpad yang menggunakan templat taskpad MMC mengabaikan parameter ini. Namun, taskpad kustom dapat menggunakannya untuk meneruskan nilai tambahan kembali ke snap-in.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Keterangan

Snap-in dapat mengidentifikasi item cakupan yang memiliki taskpad menggunakan penunjuk pdo; kemudian dapat mengidentifikasi tugas oleh nilai VARIAN yang dikembalikan dalam parameter arg. Jika taskpad adalah taskpad tampilan daftar, snap-in dapat mengidentifikasi item yang dipilih (atau item jika multiseleksi didukung) dalam daftar hasil menggunakan antarmuka IResultData . Berdasarkan data ini, snap-in dapat melakukan tindakan yang sesuai pada objek yang sesuai.

Jika tombol tampilan daftar taskpad diedit untuk taskpad tampilan daftar, snap-in dapat mengidentifikasi tombol untuk taskpad tertentu oleh nilai VARIAN yang dikembalikan dalam parameter arg.

Taskpad kustom dapat meneruskan nilai apa pun yang ditentukannya harus dikirim dalam parameter arg dan param.

Persyaratan

Lihat juga

IEnumTASK

IExtendTaskPad