Share via

SimChangeLockingPassword (Windows Embedded CE 6.0)

  • Article

1/6/2010

The SimChangeLockingPassword function changes a locking password. This function is part of the SIM Manager API set that enables access to information stored on the SIM card.

Syntax

HRESULT SimChangeLockingPassword (
  HSIM hSim,
  DWORD dwLockingFacility,
  LPTSTR lpszOldPassword,
  LPTSTR lpszNewPassword
);

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.
  • lpszOldPassword
    Pointer to the old password.
  • lpszNewPassword
    Pointer to the new password.

Return Value

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

Header simmgr.h
Library cellcore.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

SIMLOCKINGPWDLENGTH

Concepts

SIM Manager Functions