FtVspcCreatePortOverlapped Function

Creates virtual serial port with non-standard name over existing COM port.

BOOL FtVspcCreatePortOverlapped(
	LPCTSTR lpszPortName,
	LPCTSTR lpszRealPortAlias 
	);

Parameters

lpszPortName

[in] The name of virtual serial port (e.g. "COM1", "VSP25", "SERPORT10" etc). Names "COM0", "COM4294967295" and "LPTx" are prohibited.
It is recommended to use FtVspcCreatePortOverlappedByNum function for creating virtual serial ports with custom names (e.g. COMx).

lpszRealPortAlias

[in] Alias name for existing COM port. You still will be able to open existing COM port using this alias name. The string is an MS-DOS path (e.g. PORT1, COM100).

Return Value

If the function succeeds, the return value is TRUE. Otherwise, use FtVspcGetLastError to get the error code (FtVspc_ErrorCode).

Errors

ftvspcErrorFailed 1 The operation has not been completed.
ftvspcErrorInvalidParameter 2 Invalid parameter.
ftvspcErrorPortAlreadyExists 100 Physical port already exists.
ftvspcErrorNoSuchPort 101 Physical port does not exists.

Remarks

Overlapped port will be created only if physical port with specified name exists. Otherwise, ftvspcErrorNoSuchPort error will be returned.

See Also

FtVspcCreatePortOverlappedByNum