GetPinLockStatus

From IRON Test Suite
Jump to navigation Jump to search

DESCRIPTION

This command gives the status of the pin code lock on the SIM.

COMMAND

Command Input arguments Returns
GetPinLockStatus Port index PIN locking status

OUTPUT

PinLock status in the following format:
"%s\n", status

EXAMPLE

~# GetPinLockStatus 0
PIN LOCK ENABLED

~# GetPinLockStatus 1
PIN LOCK DISABLED

API

MessageCode: GRA_GET_PIN_LOCK_STATUS_REQUEST

MESSAGE BODY
Field Name Length Description
PortIndex 4 GSM Port index

The format of Message Body can be coded as the following C-language structure:

typedef struct
{
   ULONG    PortIndex;
} GRAM_GET_PIN_LOCK_STATUS_REQUEST;

MessageCode: GRA_GET_PIN_LOCK_STATUS_CONFIRM

MESSAGE BODY
Field Name Length Description
Status 4 Command status (0 if successful, otherwise see list of Error Codes Values)
PinLockStatus 4 Status of PIN Lock:
0- Disabled
1- Enabled

The format of Message Body can be coded as the following C-language structure:

typedef struct 
{
   ULONG    Status;
   ULONG    PinLockStatus;
} GRAM_GET_PIN_LOCK_STATUS_CONFIRM;