SPORT_GET_HANDLE (W*32, W*64)

Serial Port I/O Function: Returns the Windows* handle associated with the communications port. This is the handle that was returned by the Windows API CreateFile.

Module: USE IFPORT

Syntax

result = SPORT_GET_HANDLE (port, handle)

port
(Input) Integer. The port number.


handle
(Output) INTEGER(4) on IA-32 architecture; INTEGER(8) on Intel® 64 and IA-64 architectures. This is the Windows handle that was returned from CreatFile( ) on the serial port.

Results

The result type is INTEGER(4). The result is zero if successful; otherwise, a Windows error value.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also

Communications and Communications Functions in the Microsoft* Platform SDK, Building Applications: Using the Serial I/O Port Routines

Example

USE IFPORT
INTEGER(4) iresult
INTEGER(KIND=INT_PTR_KIND( )) handle
iresult = SPORT_GET_HANDLE( 2, handle )
END