IFunctionDiscoveryNotification 接口 (functiondiscoveryapi.h)

[函数发现可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]

此接口由客户端程序实现以支持异步查询,并由函数发现调用,以便在添加或删除满足查询参数的函数实例时通知客户端程序。

继承

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