SimSetLockingStatus

Send Feedback

The SimSetLockingStatus function sets the locking status of the phone. This function is part of the SIM Manager API set that enables access to information stored on the SIM card.

HRESULT SimSetLockingStatus (
  HSIM hSim,
  DWORD dwLockingFacility,
  LPTSTR lpszPassword,
  BOOL fEnabled
);

Parameters

  • hSim
    Points to a valid HSIM handle.

  • dwLockingFacility
    A SIM_LOCKFACILITY constant.

    Value Description
    SIM_LOCKFACILITY_CNTRL Lock control surface.
    SIM_LOCKFACILITY_PH_SIM Lock phone to SIM card.
    SIM_LOCKFACILITY_PH_FSIM Lock phone to first SIM card.
    SIM_LOCKFACILITY_SIM Lock SIM card.
    SIM_LOCKFACILITY_SIM_PIN2 Lock SIM card.
    SIM_LOCKFACILITY_SIM_FIXEDIALING SIM fixed dialing memory.
    SIM_LOCKFACILITY_NETWORKPERS Network personalization.
    SIM_LOCKFACILITY_NETWORKSUBPERS Network subset personalization.
    SIM_LOCKFACILITY_SERVICEPROVPERS Service provider personalization.
    SIM_LOCKFACILITY_CORPPERS Corporate personalization.
  • lpszPassword
    A pointer for some facilities that require a password.

  • fEnabled
    A Boolean value that indicates enabled or disabled.
    TRUE = enabled
    FALSE = disabled

Return Values

HRESULTs are either S_OK for success, or one of the SIM_E error constants defined in the SIM Manager Error Constants table.

Remarks

This is a privileged function.

Requirements

Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: simmgr.h
Library: cellcore.lib

See Also

SIMLOCKINGPWDLENGTH

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.