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 gets the Answer To Reset (ATR) string from the SIM.

Syntax 

HRESULT RIL_GetATR(
  HRIL 
hRil
);

Parameters

hRil

Handle to RIL instance returned by RIL_Initialize.

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 with the lpDatanotification parameter pointing to an RILATRINFOstructure.

Remarks

RIL_GetATRgives the card capabilities to the RIL client that is a standard smartcard primitive. Even though this command is not standardized in 3GPP, it is required if directly binary access to SIM cards is supported by the underlying hardware.

Requirements

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

See Also