RIL_GetCallBarringStatus

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the status of the specified type of call barring.

Syntax

HRESULT RIL_GetCallBarringStatus(
  HRIL hRil,
  DWORD dwType,
  DWORD dwInfoClass,
  LPCSTR lpszPassword
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwType
  Specifies the type of call barring to retrieve status. For values, see Call Barring Facility Constants.

• dwInfoClass
  Specifies the information class to retrieve barring status.

• lpszPassword
  Password to retrieve barring status. This value can be NULL if a password is not required. This value can be no longer than MAXLENGTH_PASSWORD characters.

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 DWORD containing a call barring status constant.

Remarks

The RIL proxy translates the RIL_GetCallBarringStatus function into IOCTL_RIL_GetCallBarringStatus when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
Call Barring Status Constants