RIL_GetGPRSRegistrationStatus

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the current phone GPRS registration status.

Syntax

HRESULT RIL_GetGPRSRegistrationStatus(
  HRIL hRil
);

Parameters

• hRil
  Handle to the 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. The lpData notification parameter points to a line registration constant.

Remarks

This function is called periodically to determine if the device has registered successfully on a GPRS network and the nature of the network it is registered on.

The RIL proxy translates the RIL_GetGPRSRegistrationStatus function into IOCTL_RIL_GetGPRSRegistrationStatus when the RIL proxy calls when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
Line Registration Constants