RIL_GetSimInfo (Compact 2013)

  • Article

3/26/2014

This function retrieves a RILSIMINFO structure for a RIL instance. This interface supports multiple SIM cards as well as changing SIM cards. The OEM implements this functionality in the radio driver by implementing IOCTL_RIL_GETSIMINFO.

Syntax

HRESULT RIL_GetSimInfo(
    HRIL hRil
);

Parameters

  • [in] hRil
    Handle to the RIL instance.

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 asynchronous result of RIL_RESULT_OK indicates success. The lpData notification parameter points to a RILSIMINFO structure.

Remarks

The OEM implements this functionality in the radio driver by implementing IOCTL_RIL_GETSIMINFO.

Detecting SIM card changes requires each SIM card provides a unique identifier. The OEM must choose an appropriate method in their RIL driver to return the SIM card presence in RILSIMINFOdwSimStatus and identifier information in RILSIMINFOwszSimID. This is because there is no standard AT command to retrieve an identifier for a SIM card. One possible identifier is the SIM card ICC ID (Integrated Circuit Card ID).

Requirements

Library

Ril.lib

See Also

Reference

RIL Functions
RILSIMINFO
RIL_EnumRadios
RIL_Initialize