INetCfgComponent::RaisePropertyUi method

Note   This method is deprecated and should not be used.

The RaisePropertyUi method either determines if a network component supports a property sheet or displays the component's property sheet, allowing users to modify the component's properties.

Syntax

HRESULT RaisePropertyUi(
  [in, optional] HWND     hwndParent,
  [in]           DWORD    dwFlags,
  [in, optional] IUnknown *pUnk
);

Parameters

• hwndParent [in, optional]
  Handle to the currently active window that owns the property sheet for a network component that RaisePropertyUi displays.

• dwFlags [in]
  A 32-bit value that specifies whether the component supports a property sheet or whether to display the component's property sheet. This value can be one of the following values from the NCRP_FLAGS enumeration:

  Value	Description
  NCRP_QUERY_PROPERTY_UI	Determine if the component supports a property sheet.
  NCRP_SHOW_PROPERTY_UI	If the component supports a property sheet, display it.

   

• pUnk [in, optional]
  Pointer to the IUnknown interface. RaisePropertyUi retrieves from IUnknown the interface of the context in which to display a network component's property sheet. RaisePropertyUi uses this interface to restrict the display of the property sheet to the context of a connection.

Return value

If the NCRP_QUERY_PROPERTY_UI flag is specified, returns zero (S_OK) if successful, indicating that the component supports a property sheet; returns S_FALSE if the component does not support a property sheet; or otherwise returns NETCFG_ Xxx codes that are defined in Netcfgx.h.

If the NCRP_SHOW_PROPERTY_UI flag is specified, returns zero (S_OK) if successful, indicating that changes were applied to the component's properties; returns S_FALSE if no changes were made; or otherwise returns NETCFG_ Xxx codes that are defined in Netcfgx.h.

Remarks

The RaisePropertyUi method calls the notify object of the network component to set the appearance of the component's property sheet and to control the notify object's behavior. For example, RaisePropertyUi calls the following sequence of interface methods of the notify object:

1. INetCfgComponentPropertyUi::QueryPropertyUi

   Determines if the given context is an appropriate context in which to display properties for the component.

2. INetCfgComponentPropertyUi::SetContext

   Directs the component's notify object to display the component's properties in the given context.

3. INetCfgComponentPropertyUi::MergePropPages

   Creates pages for the component's property sheet.

4. INetCfgComponentPropertyUi::ApplyProperties

   Stores, in memory, changes to the component's network configuration that a user enters on the page.

5. INetCfgComponentControl::ApplyRegistryChanges

   Applies the component's changes to the registry.

Requirements

See also

INetCfgComponentControl::ApplyRegistryChanges

INetCfgComponentPropertyUi::ApplyProperties

INetCfgComponentPropertyUi::MergePropPages

INetCfgComponentPropertyUi::QueryPropertyUi

INetCfgComponentPropertyUi::SetContext

Send comments about this topic to Microsoft