Share via

SimUnlockPhone (Windows Embedded CE 6.0)

  • Article

1/6/2010

The SimUnlockPhone function sends a password to unlock the phone. This function is part of the SIM Manager API set that enables access to information stored on the SIM card.

Syntax

HRESULT SimUnlockPhone (
  HSIM hSim,
  LPTSTR lpszPassword,
  LPTSTR lpszNewPin
);

Parameters

  • hSim
    Points to a valid HSIM handle.
  • lpszPassword
    Points to a password string.
  • lpszNewPin
    Points to a second password string. Some locked states require a second password. for example, a pointer to an unknown (PUK) requires a new PIN to replace the old, presumably forgotten, PIN. The values can be NULL.

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
SimGetPhoneLockedState

Concepts

SIM Manager Functions