Antarmuka IFunctionDiscoveryNotification (functiondiscoveryapi.h)

[Penemuan Fungsi tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Antarmuka ini diimplementasikan oleh program klien untuk mendukung kueri asinkron dan dipanggil oleh Penemuan Fungsi untuk memberi tahu program klien ketika instans fungsi yang memenuhi parameter kueri telah ditambahkan atau dihapus.

Warisan

Antarmuka IFunctionDiscoveryNotification mewarisi dari antarmuka IUnknown . IFunctionDiscoveryNotification juga memiliki jenis anggota ini:

Metode

Antarmuka IFunctionDiscoveryNotification memiliki metode ini.

IFunctionDiscoveryNotification::OnError Menerima kesalahan yang terjadi selama pemrosesan kueri asinkron.
IFunctionDiscoveryNotification::OnEvent Menerima peristiwa tambahkan, hapus, atau perbarui selama pemberitahuan.
IFunctionDiscoveryNotification::OnUpdate Menunjukkan bahwa instans fungsi telah ditambahkan, dihapus, atau diubah.

Keterangan

Antarmuka ini harus diimplementasikan oleh program klien untuk menerima pemberitahuan dari Penemuan Fungsi. Alamat implementasi program klien diteruskan ke salah satu metode kueri untuk mengaktifkan pemberitahuan untuk instans fungsi yang memenuhi parameter kueri.

Penemuan Fungsi memanggil metode IFunctionDiscoveryNotification::OnUpdate program klien untuk melakukan pemberitahuan aktual, yang dihasilkan untuk instans fungsi saat ditambahkan atau dihapus.

Catatan Beberapa penyedia penemuan Fungsi juga akan menghasilkan pemberitahuan ketika instans fungsi dimodifikasi dengan mengubah kategori atau satu atau beberapa properti yang ditetapkan untuknya.

 

Contoh

Contoh yang muncul pada halaman metode individual didasarkan pada deklarasi kelas berikut.

class CMyNotificationListener : public CFunctionDiscoveryNotificationWrapper
{
public:
    CMyNotificationListener() {
        m_hAddEvent      = CreateEvent( NULL, FALSE, FALSE, NULL );
        m_hRemoveEvent   = CreateEvent( NULL, FALSE, FALSE, NULL );
        m_hChangeEvent   = CreateEvent( NULL, FALSE, FALSE, NULL );
    }

    ~CMyNotificationListener() {
        CloseHandle( m_hAddEvent );
        CloseHandle( m_hRemoveEvent );
        CloseHandle( m_hChangeEvent );
    }
        

private:
    HANDLE m_hAddEvent, m_hRemoveEvent, m_hChangeEvent;
};

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	functiondiscoveryapi.h