INetCfgComponentPropertyUi::ValidateProperties method

The ValidateProperties method directs the notify object of the network component to validate any proposed changes for the component's properties.

Syntax

HRESULT ValidateProperties(
  [in] HWND hwndSheet
);

Parameters

• hwndSheet [in]
  Handle to the custom property sheet created by the notify object for the network component that owns the object. The notify object validates any proposed changes for the component's properties within the pages of this property sheet.

Return value

Returns zero (S_OK) if successful; otherwise, returns NETCFG_* codes that are defined in Netcfgx.h. If the return value is anything other than S_OK, the notify object can stop the property sheet from closing.

Remarks

The network configuration subsystem calls ValidateProperties after a user clicks either OK or Apply on a custom property sheet. If ValidateProperties finds problems with any proposed changes for the component's properties, it informs the user.

An individual custom property page loses focus as the user activates another page. As a page loses focus, it receives property sheet messages for validation. Each page's dialog box procedure processes these messages before the network configuration subsystem calls ValidateProperties.

After the network configuration subsystem calls ValidateProperties, the notify object validates any dependencies that arise between custom property pages.

Requirements

Send comments about this topic to Microsoft