INetCfgComponent::GetCharacteristics method

The GetCharacteristics method retrieves the characteristics that describe a network component and that restrict a user's actions on the component.

Syntax

HRESULT GetCharacteristics(
  [out] LPDWORD pdwCharacteristics
);

Parameters

• pdwCharacteristics [out]
  Pointer to a 32-bit variable that receives a mask enumerating the characteristics of a network component. A network component can have a combination of the following characteristics from the COMPONENT_CHARACTERISTICS enumeration:

  Value	Description
  NCF_VIRTUAL	Emulates a physical network card.
  NCF_SOFTWARE_ENUMERATED	Software-enumerated component.
  NCF_PHYSICAL	Physical network card.
  NCF_HIDDEN	Hidden from the view of a user (that is, does not appear in any user interface).
  NCF_NO_SERVICE	No associated network service.
  NCF_NOT_USER_REMOVABLE	Cannot be removed by the user. For example, Control Panel, Device Manager, and Hardware Wizard.
  NCF_MULTIPORT_INSTANCED_ADAPTER	Network card with separate miniport driver instances for each adapter port.
  NCF_HAS_UI	Has a property sheet for displaying and changing properties.
  NCF_FILTER	Filter component whose bindings are treated differently.

   

Return value

Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h. If the pdwCharacteristics parameter is NULL, GetCharacteristics returns E_POINTER.

Remarks

The network characteristics NCF_VIRTUAL, NCF_SOFTWARE_ENUMERATED, and NCF_PHYSICAL are mutually exclusive.

A network component that has the characteristics of NCF_VIRTUAL, NCF_SOFTWARE_ENUMERATED, or NCF_PHYSICAL cannot also have the NCF_NO_SERVICE characteristic.

Requirements

Send comments about this topic to Microsoft