SplPdInstallPort

SplPdInstallPort tells the port driver the name of the port that needs to be installed.

Syntax
SplPdInstallPort(hab, pszPortName);

Parameters

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


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

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 anchor block. */ PSZ      pszPortName;  /*  The name of the port to be installed. */ APIERR   rc;           /*  Return codes. */

rc = SplPdInstallPort(hab, pszPortName);

Remarks
This function is called from the Workplace Shell. The port driver writes the initialization data from the INI file. The Workplace Shell then typically calls SplPdSetPort.