IFunctionDiscoveryNotification 介面 (functiondiscoveryapi.h)

[函式探索可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]

這個介面是由用戶端程式所實作，以支援異步查詢，而且由 Function Discovery 呼叫，以在符合查詢參數的函式實例已加入或移除時通知用戶端程式。

繼承

IFunctionDiscoveryNotification 介面繼承自 IUnknown 介面。 IFunctionDiscoveryNotification 也有下列類型的成員：

方法

IFunctionDiscoveryNotification 介面具有這些方法。

IFunctionDiscoveryNotification：：OnError 接收異步查詢處理期間發生的錯誤。
IFunctionDiscoveryNotification：：OnEvent 在通知期間接收任何新增、移除或更新事件。
IFunctionDiscoveryNotification：：OnUpdate 指出已新增、移除或變更函式實例。

備註

此介面必須由用戶端程序實作，才能接收來自函式探索的通知。 用戶端程序實作的位址會傳遞至其中一個查詢方法，以啟用符合查詢參數之函式實例的通知。

函式探索會呼叫用戶端程式的 IFunctionDiscoveryNotification：：OnUpdate 方法，以執行實際通知，這會在新增或移除函式實例時產生。

注意 某些函式探索提供者也會藉由變更類別或指派給它的一或多個屬性來修改函式實例時產生通知。

 

範例

個別方法頁面上出現的範例是以下列類別宣告為基礎。

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

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	functiondiscoveryapi.h