RIL_ChangeCallBarringPasswordEx (Compact 2013)

3/26/2014

This function is used to send all user-entered call barring passwords to the network for validation.

When changing call barring passwords, the user can be asked to confirm the new password by entering the new password a second time. This function sends the old password, the new password, and the confirming password, to the network.

Syntax

HRESULT RIL_ChangeCallBarringPassword(
  HRIL hRil,
  DWORD dwType,
  LPCSTR lpwszOldPassword,
  LPCSTR lpwszNewPassword
  LPCSTR lpwszNewPasswordConfirm

);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

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

• lpwszOldPassword
  Current password, no longer than MAXLENGTH_PASSWORD characters. For maximum length values, see Maximum Lengths Constants.

• lpwszNewPassword
  New password, no longer than MAXLENGTH_PASSWORD characters.

• lpwszNewPasswordConfirm
  New password re-entered for confirmation, 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 is set to NULL.

An error value of RIL_E_PASSWORDMISMATCH indicates a mismatch between the new password and the confirming password.

Remarks

The RIL proxy translates the RIL_ChangeCallBarringPasswordEX function into IOCTL_RIL_ChangeCallBarringPasswordEX when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL Functions
RIL_ChangeCallBarringPassword
Error Constants