INetCfgComponentNotifyGlobal::GetSupportedNotifications method

Artigo
06/19/2017

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)

Compartilhar via