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

Sends the user string to the device for authentication key (AKey) verification.

Syntax 

HRESULT RIL_SendAKey(
  HRIL 
hRil,
  LPCSTR 
lpszChars
);

Parameters

hRil

Handle to the RIL instance returned by RIL_Initialize.

lpszChars

A string representing the AKey characters. Valid characters are 0-9, * and #.

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 parameteris set to NULL.

Remarks

An AKey(or A-Key) is an authentication key used on CDMA devices. It is a 64 bit key, with 0-20 digits of data and a 6 digit checksum. Part of the key is usually specific to the device manufacturer or operator.

This function has not been implemented in the sample RIL driver.

Requirements

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

See Also

Reference

RIL_Initialize