About PortController
Introduction
Purchasing PortController
Redistributing PortController
License Agreement
Support
Getting Started
How to Use PortController
PortController Sample Projects
Handling PortController Errors
Reference
Properties
AvailableSystemPorts
BaudRate Property
Break Property
BytesUsedRQ Property
BytesUsedTQ Property
Cd Property
Cts Property
DataBits Property
Dsr Property
Dtr Property
DtrDsr Property
EnableReadOnEventChar Property
EventChar Property
ForceBeginInvokeEventFiring Property
IsOpen Property
IsFileTransferInProgress Property
Parity Property
PortHandle Property
PortName Property
ReceiveBufferSize Property
Ring Property
Rts Property
RtsCts Property
StopBits Property
SystemPorts Property
TraceOutput Property
TransmitBufferSize
XoffByte Property
XonByte Property
XonXoff Property
Methods
CancelFileTransfer Method
ClearRQ Method
ClearTQ Method
Close Method
GetErrorStatus Method
Open Method
Read Method
ReadBinary Method
ReceiveFileXModem Method
ReceiveFileXModemCRC Method
ReceiveFileYModem Method
ReceiveFileZModem Method
SendFileXModem Method
SendFileXModem1k Method
SendFileYModem Method
SendFileZModem Method
SimulateReceivedXoff Method
SimulateReceivedXon Method
Write Method
WriteBinary Method
Events
OnBreakSignal Event
OnCdToggle Event
OnCtsToggle Event
OnDataReceived Event
OnDsrToggle Event
OnError Event
OnEventCharReceived Event
OnFileTransferComplete Event
OnFileTransferStatusUpdate Event
OnRing Event
OnTQEmpty Event

PortHandle Property

Returns an IntPtr HANDLE to the open communications port.

Syntax

[Visual Basic]
object.PortHandle

[C#]
object.PortHandle

[C++]
object->PortHandle

Parameters

object

An object expression that evaluates to a PortController object.

Return Value

An IntPtr HANDLE to the currently open communications port.

Remarks

  • The returned handle to the communications port may be used as the file handle in unmanaged Win32 function calls.
  • This property is read-only.

Errors

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

Example

[Visual Basic]
Dim portHandle As IntPtr
portHandle = myPortController.PortHandle


[C#]
IntPtr portHandle = myPortController.PortHandle;


[C++]
IntPtr portHandle = myPortController->PortHandle;

See Also

PortName property