SimChangeLockingPassword (Windows Embedded CE 6.0)

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

See Also

Reference

SIMLOCKINGPWDLENGTH

Concepts

SIM Manager Functions