ConfigurePort

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
winspool.lib
Header File
winspool.h
Unicode
WinNT
Platform Notes
None

The ConfigurePort function displays the port-configuration dialog box for a port on the specified server.

BOOL ConfigurePort(

LPTSTR pName,	// pointer to server name
HWND hWnd,	// handle to parent window of the dialog box
LPTSTR pPortName	// pointer to port name
);

Parameters
pName

Points to a null-terminated string that specifies the name of the server on which the specified port exists. If this parameter is NULL, the port is local.

hWnd

Identifies the parent window of the port-configuration dialog box.

pPortName

Points to a null-terminated string that specifies the name of the port to be configured.

Return Values
If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks
Before calling the ConfigurePort function, an application should call the EnumPorts function to determine valid port names.