RIL_SendRestrictedSimCmd

RIL_SendRestrictedSimCmd

Switch on low bandwidth view

Collapse All

Language Filter

9/17/2008

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 RILSIMCMDPARAMETERS structure populated with the parameters for the command to be sent. Can be NULL if no parameters are required.

lpbData: Data to be written to the SIM. Can be NULL if no data is required.

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

Return Value

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

An asychronous result of RIL_RESULT_OK indicates success. The lpData notification parameter points to an RILSIMRESPONSE structure.

Remarks

Use the RIL_SendRestrictedSimCmd function to read a transparent (binary) file larger than 255 bytes instead of SimReadRecord. To do this, set the dwCommand parameter to RIL_SIMCMD_READBINARY. When populating the lpParameters parameter, set dwParameter1 to the high offset of the data to be read, set dwParameter2 to the low offset of the data to be read and set dwParameter3 to the length, in bytes, of the data to be read.

The RIL proxy translates the RIL_SendRestrictedSimCmd function into IOCTL_RIL_SendRestrictedSimCmd when the RIL proxy calls RIL_IOControl.

Requirements

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

Reference

RIL_Initialize
RILSIMRESPONSE
RILSIMCMDPARAMETERS
SIM Command Constants