About GPS ToolKit
Introduction
Purchasing GPS ToolKit
Redistributing GPS ToolKit
License Agreement
Support
Getting Started
How to Use GPS ToolKit
Adding GPS ToolKit to a Visual Basic Project
Adding GPS ToolKit to a Visual C++ Project
Adding GPS ToolKit to an Excel Worksheet
Setting up the GPS
How to Use Events
Handling Events in Visual Basic
Handling Events in Visual C++
Handling Events in Microsoft Excel
GPS ToolKit Sample Projects
Handling GPS ToolKit Errors
Reference
Properties
Altitude
AltitudeUnits
ArrivedAtDest
AutomaticOperation
BaudRate
CrossTrackError
DegLabel
DestClosingVelocity
DestWptID
DestWptLatitude
DestWptLongitude
DistUnits
DGPSRefStationID
FixDateTime
FixGood
FixQuality
FixSatellitePRNs
GeoidHeightAboveWGS84Ellipsoid
HDOP
Latitude
LatLonFormat
Longitude
MagVariation
MinLabel
ModeIndicator
NumSatellitesInFix
NumSatellitesInView
OperationMode
OrigToDestMagBearing
OrigToDestTrueBearing
OriginWptID
PDOP
PortHandle
PortName
RangeToDest
RouteContainsAllWpts
RouteName
SatelliteInViewPRNs
SecLabel
Speed
SpeedUnits
TimeSinceLastDGPSUpdate
TrueBearingToDest
TrueCourse
VDOP
WptsInRoute
Methods
Close
GetSatelliteInfo
GetWptLocation
Open
OpenFile
Events
FixUpdate
FileComplete
NavUpdate
RawDataReceived
SatelliteUpdate

PortHandle Property

Returns a Win32 (long integer) handle to the communications port.

Syntax

Visual Basic

object.PortHandle

Visual C++

object.GetPortHandle()

Part Description
object An object expression that evaluates to a GPS ToolKit object.

Example

Visual Basic

Dim handle As Long

'Get the port handle
handle = myGPSToolKit.PortHandle

Visual C++

_variant_t vtPortHandle;

// Get the port handle
vtPortHandle = m_myGPSToolKit.GetPortHandle();

Remarks

This handle may be used when it is necessary to call a Win32 function directly.

Returns

A VARIANT (VT_I4/long) containing the Win32 long integer handle to the communications port.

Errors

Reading the PortHandle property while the port is closed is not permitted and will cause GPS ToolKit to throw a "Port is closed" exception.

See Also

PortName