CreatePortEx Method

Creates virtual serial port with non-standard name and allows replacing the value of FriendlyName and CompanyName (indicated by the license key) with alternative values.

Custom license key is needed to unlock this method. Otherwise it fails.

Syntax

Visual Basic
Sub CreatePortEx(PortName As String, FriendlyName As String, CompanyName As String) 
Delphi
procedure CreatePortEx(PortName: String, FriendlyName: String, CompanyName: String); 
Visual C++ (MFC)
void CreatePortEx(LPCTSTR PortName, LPCTSTR FriendlyName, LPCTSTR CompanyName);
Visual C++ (#import)
void CreatePortEx(_bstr_t PortName, _bstr_t FriendlyName, _bstr_t CompanyName);

Parameters

PortName

[in] The name of virtual serial port (e.g. "COM1", "VSP25", "SERPORT10" etc). The names "COM0" and "LPTx" are prohibited.

FriendlyName

[in] FriendlyName Value. If NULL – the value integrated into the license key is used. Can be set only if any FriendlyName is integrated into the license key, otherwise it fails with ftvspcErrorInvalidLicense error.

CompanyName

[in] Company name. If NULL - the value integrated into the license key is used. Can be set only if any FriendlyName is integrated into the key, otherwise it fails with ftvspcErrorInvalidLicense error.

Return

TRUE - the port has been created successfully, FALSE otherwise.

Errors

The method may throw exception. Use GetLastError method to get the error code.

ftvspcErrorFailed 1 The operation has not been completed.
ftvspcErrorInvalidParameter 2 Invalid parameter.
ftvspcErrorInvalidLicense 5 Invalid license.
ftvspcErrorPortAlreadyExists 100 This port already exists.

See Also

CreatePort