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
Target platform |
Desktop |
Header |
Netcfgx.h (include Netcfgx.h) |