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 sends a specified restricted command to the SIM.

Syntax

HRESULT RIL_SendRestrictedSimCmd(
  HRIL 
hRil,
  DWORD 
dwCommand,
  const RILSIMCMDPARAMETERS* 
lpParameters,
  const BYTE* 
lpbData,
  DWORD 
dwSize
);

Parameters

hRil

Handle to the RIL instance returned by RIL_Initialize.

dwCommand

Specifies the restricted command to be sent to the SIM. For values, see SIM Command Constants.

lpParameters

A RILSIMCMDPARAMETERSstructure populated with the parameters for the command to be sent. Can be NULLif no parameters are required.

lpbData

Data to be written to the SIM. Can be NULLif no data is required.

dwSize

Specifies the size of the data pointed to by lpbData,in bytes.

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.

An asychronous result of RIL_RESULT_OKindicates success. The lpDatanotification parameter points to an RILSIMRESPONSEstructure.

Remarks

Use the RIL_SendRestrictedSimCmdfunction to read a transparent (binary) file larger than 255 bytes instead of SimReadRecord. To do this, set the dwCommandparameter to RIL_SIMCMD_READBINARY. When populating the lpParametersparameter, set dwParameter1to the high offset of the data to be read, set dwParameter2to the low offset of the data to be read and set dwParameter3to the length, in bytes, of the data to be read.

The RIL proxy translates the RIL_SendRestrictedSimCmdfunction into IOCTL_RIL_SendRestrictedSimCmdwhen the RIL proxy calls RIL_IOControl.

Requirements

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

See Also