Interfaccia IFunctionDiscoveryNotification (functiondiscoveryapi.h)

[L'individuazione delle funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Questa interfaccia viene implementata dal programma client per supportare le query asincrone e viene chiamata da Individuazione funzione per notificare al programma client quando un'istanza di funzione che soddisfa i parametri di query è stata aggiunta o rimossa.

Ereditarietà

L'interfaccia IFunctionDiscoveryNotification eredita dall'interfaccia IUnknown . IFunctionDiscoveryNotification include anche questi tipi di membri:

Metodi

L'interfaccia IFunctionDiscoveryNotification include questi metodi.

IFunctionDiscoveryNotification::OnError Riceve errori che si verificano durante l'elaborazione asincrona delle query.
IFunctionDiscoveryNotification::OnEvent Riceve eventuali eventi di aggiunta, rimozione o aggiornamento durante una notifica.
IFunctionDiscoveryNotification::OnUpdate Indica che un'istanza di funzione è stata aggiunta, rimossa o modificata.

Commenti

Questa interfaccia deve essere implementata dal programma client per ricevere notifiche dall'individuazione delle funzioni. L'indirizzo dell'implementazione del programma client viene passato a uno dei metodi di query per abilitare le notifiche per le istanze di funzione che soddisfano i parametri di query.

L'individuazione funzioni chiama il metodo IFunctionDiscoveryNotification::OnUpdate del programma client per eseguire la notifica effettiva, generata per un'istanza di funzione quando viene aggiunta o rimossa.

Nota Alcuni provider di individuazione delle funzioni genereranno anche una notifica quando un'istanza di funzione viene modificata modificando una categoria o una o più proprietà assegnate.

 

Esempio

Gli esempi visualizzati nelle singole pagine del metodo sono basati sulla dichiarazione di classe seguente.

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;
};

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h