RIL_UnlockPhone (Windows Embedded CE 6.0)
1/6/2010
This function removes the current lock applied to the phone.
Syntax
HRESULT RIL_UnlockPhone(
HRIL hRil,
LPCSTR lpszPassword,
LPCSTR lpszNewPassword
);
Parameters
- hRil
Handle to the RIL instance returned by RIL_Initialize.
- lpszPassword
Password to unlock the phone. This value can be no longer than MAXLENGTH_PASSWORD characters.
- lpszNewPassword
New password. This value can be set to NULL, unless the current locked state is one of the RIL_LOCKEDSTATE_*_PUK constants. 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 asychronous result of RIL_RESULT_OK indicates success. The lpData notification parameter is set to NULL.
Remarks
The RIL proxy translates the RIL_UnlockPhone function into IOCTL_RIL_UnlockPhone when the RIL proxy calls RIL_IOControl.
Requirements
| Header | ril.h |
| Library | Ril.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |