RIL_GetLockingStatus

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves locking status for the specified facility.

Syntax

HRESULT RIL_GetLockingStatus(
  HRIL hRil,
  DWORD dwFacility,
  LPCSTR lpszPassword
);

Parameters

• hRil
  Handle to the RIL instance returned by RIL_Initialize.

• dwFacility
  Specifies the facility to retrieve locking status. For values, see Lock Facility Constants.

• lpszPassword
  Password to retrieve locking status. This value can be NULL if a password is not required. 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 asynchronous result of RIL_RESULT_OK indicates success. The lpData notification parameter points to a DWORD containing a lock status constant.

Remarks

The RIL proxy translates the RIL_GetLockingStatus function into IOCTL_RIL_GetLockingStatus when the RIL proxy calls RIL_IOControl.

Requirements

See Also

Reference

RIL_Initialize
Lock Facility Constants
Lock Status Constants