Partager via


INetCfgComponentNotifyGlobal::GetSupportedNotifications method

The GetSupportedNotifications method retrieves the types of notifications that the notify object of the network component requires from the network configuration subsystem.

Syntax

HRESULT GetSupportedNotifications(
  [out] DWORD *pdwNotifications
);

Parameters

  • pdwNotifications [out]
    Pointer to a 32-bit variable that receives a mask enumerating the notifications that the notify object of the network component requires from the network configuration subsystem. A notify object can require a combination of the following notification types from the BIND_FLAGS1 enumeration:

    Value Description

    NCN_ADD

    Notifies if adding components.

    NCN_REMOVE

    Notifies if removing components.

    NCN_UPDATE

    Notifies if updating components.

    NCN_ENABLE

    Notifies if enabling components.

    NCN_DISABLE

    Notifies if disabling components.

    NCN_BINDING_PATH

    Notifies if binding paths change.

    NCN_PROPERTYCHANGE

    Notifies if a component's properties change.

    NCN_NET

    Notifies if network cards change.

    NCN_NETTRANS

    Notifies if transports change.

    NCN_NETCLIENT

    Notifies if clients change.

    NCN_NETSERVICE

    Notifies if network services change.

     

    Note  NetClient components are deprecated in Windows 8.1, Windows Server 2012 R2, and later.

     

Return value

Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h.

Remarks

The network configuration subsystem calls GetSupportedNotifications immediately after the subsystem creates an instance of the notify object of the network component, and probably before the subsystem calls any other interface methods implemented for the notify object. After the network configuration subsystem creates an instance of the network component's notify object, the object's INetCfgComponentControl::Initialize method prepares the object for a GetSupportedNotifications call.

Requirements

Target platform

Desktop

Header

Netcfgn.h (include Netcfgn.h)

See also

INetCfgComponentControl::Initialize

 

 

Send comments about this topic to Microsoft