RIL_GetSerialPortHandleFromContextID (Compact 2013)

  • Article

3/26/2014

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

  • dwContextID
    The PDP context identifier.
  • lphSerial
    Pointer to the serial port handle.

Return Value

An HRESULT value of S_OK indicates success. HRESULT values of E_XXX indicate an error. Errors are defined in the winerror.h file.

Remarks

This function is synchronous. An asynchronous result callback is not returned.

The parameter dwContextID is input and lphSerial points to the final result. The client is responsible for closing the serial port returned using lphSerial.

The RIL proxy translates the RIL_GetSerialPortHandleFromContextID into IOCTL_RIL_GETSERIALPORTHANDLEFROMCONTEXTID when the RIL proxy calls RIL_IOCONTROL.

Requirements

Header

ril.h

Library

Ril.lib

See Also

Reference

RIL Functions
RIL_GetSerialPortHandle