Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

SerialDisplayAdvancedSettings function

SerialDisplayAdvancedSettings displays the system-supplied advanced settings dialog box for a specified COM port device.

Syntax


LONG SerialDisplayAdvancedSettings(
  _In_  HWND ParentHwnd,
  _In_  HDEVINFO DeviceInfoSet,
  _In_  PSP_DEVINFO_DATA DeviceInfoData
);

Parameters

ParentHwnd [in]

Handle to the parent window for the advanced settings dialog box.

DeviceInfoSet [in]

Specifies the device information set that includes the device instance specified by DeviceInfoData.

DeviceInfoData [in]

Pointer to the device instance in the specified device information set. The routine displays the advanced settings dialog box for this device.

Return value

SerialDisplayAdvancedSettings returns one of the following status values.

Return codeDescription
ERROR_SUCCESS

The advanced settings dialog box was successfully displayed.

ERROR_INVALID_PARAMETER

One of the following occurred: The specified device information set is not valid.

ERROR_ACCESS_DENIED

The routine could not open the specified device's hardware registry key.

ERROR_INVALID_DATA

The name of the port is not valid.

ERROR_ACCESS_DENIED

The routine could not display the dialog box.

 

Remarks

SerialDisplayAdvancedSettings displays the system-supplied advanced settings dialog box for a specified device. If you supply a custom dialog box, this routine displays it; otherwise, the routine displays the default dialog box.

SerialDisplayAdvancedSettings runs in user mode.

For more information, see Installing an Advanced Properties Page for a COM Port.

Requirements

Header

Msports.h (include Msports.h)

Library

Msports.lib

See also

PPORT_ADVANCED_DIALOG

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.