Share via


INetCfgComponentPropertyUi

The INetCfgComponentPropertyUi interface provides methods that inform a notify object of a user's request to display the properties of the network component that owns the object. These methods also inform the notify object that the network configuration subsystem must apply changes to the component's properties.

The interface identifier (IID) for this interface is IID_INetCfgComponentPropertyUi.

When to Implement

Implement the methods of this interface to display custom property pages for the network component that owns this notify object. This interface is optional.

When to Use

The network configuration subsystem calls the INetCfgComponentPropertyUi methods to inform a notify object of a user's request to display the properties of the network component that owns the object, and whether the network configuration subsystem must apply changes to the component's properties.

Methods

The following methods are listed in Vtable order:

IUnknown method Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments the reference count.

Release

Decrements the reference count.

 

INetCfgComponentPropertyUi method Description

QueryPropertyUi

Determines if the given context is appropriate for displaying properties for the component that owns the notify object.

SetContext

Directs the component's notify object to display the component's properties in the context of a particular binding path or adapter.

MergePropPages

Creates custom property pages and merges them into the component's default set.

ValidateProperties

Checks proposed changes for the component's properties.

ApplyProperties

Stores, in memory, proposed changes for the component's properties.

CancelProperties

Disregards proposed changes for the component's properties.

 

Comments

If a network component does not supply custom property pages that users can use to modify the component's properties, the INetCfgComponentPropertyUi interface does not need to be implemented for the component's notify object.

E_NOTIMPL is not a valid return type for any of the methods of INetCfgComponentPropertyUi.

Requirements

Header

Netcfgn.h (include Netcfgn.h)

 

 

Send comments about this topic to Microsoft