SplPdSetPort

SplPdSetPort displays a dialog to allow the user to browse and modify port configurations.

Syntax
SplPdSetPort(hab, pszPortName, flModified);

Parameters

 * hab (HAB) - input
 * The handle to the anchor block.


 * pszPortName (PSZ) - input
 * The name of the port to be removed.


 * flModified (PULONG) - input
 * A flag to indicate that the configuration has been modified.

Returns

 * rc (APIERR) - returns : Return codes.

This handling routine returns the following errors:
 * ERROR_INVALID_PARAMETER
 * NO_ERROR

Sample

 * 1) include 

HAB      hab;          /*  The handle to the anchor block. */ PSZ      pszPortName;  /*  The name of the port to be removed. */ PULONG   flModified;   /*  A flag to indicate that the configuration has been modified. */ APIERR   rc;           /*  Return codes. */

rc = SplPdSetPort(hab, pszPortName, flModified);

Remarks
This function is called from the Workplace Shell. The port driver retrieves the values previously stored in OS2SYS.INI and displays a dialog box. Default values are used the first time if no previous values were stored in OS2SYS.INI.

When the user selects OK from the dialog box, the port driver stores the changed values back into OS2SYS.INI. The flag flModified is not set if the user did not modify anything or if the user selected CANCEL from the dialog box.


 * Note: The dialog should contain everything required for port initialization and termination.