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