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 |
|---|---|
Determines if the given context is appropriate for displaying properties for the component that owns the notify object. |
|
Directs the component's notify object to display the component's properties in the context of a particular binding path or adapter. |
|
Creates custom property pages and merges them into the component's default set. |
|
Checks proposed changes for the component's properties. |
|
Stores, in memory, proposed changes for the component's properties. |
|
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) |