RIL_SetCallBarringStatus

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function enables or disables the specified type of call barring.

Syntax

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

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwType
  Specifies the type of call barring to enable or disable. For values, see Call Barring Facility Constants.

• dwInfoClass
  Specifies the information class to enable or disable call barring. For values, see Information Class Constants.

• lpszPassword
  Password to enable or disable call barring. This value can be set to NULL if a password is not required. This value can be no longer than MAXLENGTH_PASSWORD characters.

• dwStatus
  Specifies the status to be set. For values, see Call Barring Status Constants.

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 asychronous result of RIL_RESULT_OK indicates success.The lpData notification parameter is set to NULL.

Remarks

The RIL proxy translates the RIL_SetCallBarringStatus function into IOCTL_RIL_SetCallBarringStatus when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
Call Barring Facility Constants
Information Class Constants
Call Barring Status Constants