RIL_ChangeLockingPassword (Compact 2013)

3/26/2014

This function changes the locking password for the designated facility.

Syntax

HRESULT
 RIL_ChangeLockingPassword(
  HRIL hRil,
  DWORD dwFacility,
    DWORD dwOldPasswordType
  LPCSTR lpszOldPassword,
  LPCSTR lpszNewPassword
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwFacility
  Designates the facility to change the locking password. For values, see Lock Facility Constants.

• dwOldPasswordType
  The type of old password (PIN or PUK). Can be either RIL_PASSWORDTYPE_PIN for editable passwords or RIL_PASSWORDTYPE_PUK for passwords that are not editable by users.

• lpszOldPassword
  Current locking password. Can be either RIL_PASSWORDTYPE_PIN for editable passwords or RIL_PASSWORDTYPE_PUK for passwords that are not editable by users.

• lpszNewPassword
  New locking password. Must 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 is set to NULL.

Remarks

The RIL proxy translates the RIL_ChangeLockingPassword function into IOCTL_RIL_ChangeLockingPassword when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL Functions
RIL_Initialize
Lock Facility Constants