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
Header |
ril.h |
Library |
Ril.lib |