Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function enables or disables locking status for the specified facility.

Syntax 

HRESULT RIL_SetLockingStatus(
  HRIL 
hRil,
  DWORD 
dwFacility,
  LPCSTR 
lpszPassword,
  DWORD 
dwStatus
);

Parameters

hRil

Handle to the RIL instance returned by RIL_Initialize.

dwFacility

Specifies the facility to enable or disable locking. For values, see Lock Facility Constants.

lpszPassword

Password to enable or disable locking. This value can be set to NULLif 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 Lock Status Constants.

Return Value

Positive HRESULTvalues indicate success and are used as command identifications for matching the asynchronous call result. Negative HRESULTvalues indicate an error. Errors are defined in the Ril.h file.

An asychronous result of RIL_RESULT_OKindicates success. The lpDatanotification parameter is set to NULL.

Remarks

The RIL proxy translates the RIL_SetLockingStatusfunction into IOCTL_RIL_SetLockingStatuswhen the RIL proxy calls RIL_IOControl.

Requirements

Header ril.h
Library Ril.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also