Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves a serial port handle from the PDP context to be used for data communications.

Syntax 

HRESULT RIL_GetSerialPortHandleFromContextID(
  HRIL 
hRil,
  DWORD 
dwContextID,
  HANDLE 
*lphSerial
);

Parameters

hRil

Handle to the RIL instance returned by RIL_Initialize.

dwContextID

The PDP context identifier.

lphSerial

Pointer to the serial port handle.

Return Value

Positive HRESULTvalues indicate success and are used as command identifications for matching the asynchronous call result. Negative HRESULTvalues indicate an error. Errors are defined in the Ril.h file.

Remarks

This function is synchronous. The client is responsible for closing the serial port returned using lphSerial.

Requirements

Header ril.h
Library Ril.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also