Share via

SIMPHONEBOOKENTRYEX

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The SIMPHONEBOOKENTRYEX structure supports an extended SIM phonebook entry. This structure is part of the SIM Manager API set that enables access to information stored on the SIM card.

Syntax

typedef struct simphonebookentryex_tag {
  DWORD cbSize;
  DWORD dwParams;
  TCHAR lpszAddress[MAX_LENGTH_ADDRESS];
  DWORD dwAddressType;
  DWORD dwNumPlan;
  TCHAR lpszText[MAX_LENGTH_PHONEBOOKENTRYTEXT];
    TCHAR lpszSecondName[MAX_LENGTH_PHONEBOOKENTRYTEXT];
    DWORD dwIndex;
  BOOL fHidden;
    DWORD dwGroupIdCount;
    DWORD rgdwGroupId[MAX_NUM_GROUPS];
   DWORD dwUid;
    DWORD dwAdditionalNumberCount;
   LPSIMPHONEBOOKADDITIONALNUMBER lpAdditionalNumbers;
    DWORD dwEmailCount;
    LPSIMPHONEBOOKEMAILADDRESS lpEmailAddresses;
} SIMPHONEBOOKENTRYEX, *LPSIMPHONEBOOKENTRYEX;

Members

  • cbSize
    Size of the structure in bytes.
  • dwParams
    Indicates valid parameter values.
  • lpszAddress
    An array for the actual phone number.

  • dwAddressType
    A SIM_ADDRTYPE constant.

    Value Description

    SIM_ADDRTYPE_UNKNOWN

    Unknown.

    SIM_ADDRTYPE_INTERNATIONAL

    International number.

    Note The address should be prefixed with a "+" (plus sign), if not already, before being displayed to the user. Likewise, when writing an entry to the SIM, this needs to be written correctly.

    SIM_ADDRTYPE_NATIONAL

    National number.

    SIM_ADDRTYPE_NETWKSPECIFIC

    Network specific number.

    SIM_ADDRTYPE_SUBSCRIBER

    Subscriber number (protocol-specific).

    SIM_ADDRTYPE_ALPHANUM

    Alphanumeric address.

    SIM_ADDRTYPE_ABBREV

    Abbreviated number.

  • dwNumPlan
    A SIM_NUMPLAN constant.

    Value Description

    SIM_NUMPLAN_UNKNOWN

    Unknown.

    SIM_NUMPLAN_TELEPHONE

    ISDN/telephone numbering plan (E.164/E.163).

    SIM_NUMPLAN_DATA

    Data numbering plan (X.121).

    SIM_NUMPLAN_TELEX

    Telex numbering plan.

    SIM_NUMPLAN_NATIONAL

    National numbering plan.

    SIM_NUMPLAN_PRIVATE

    Private numbering plan.

    SIM_NUMPLAN_ERMES

    ERMES numbering plan (ETSI DE/PS 3 01-3).
  • lpszText[MAX_LENGTH_PHONEBOOKENTRYTEXT]
    Text associated with the entry.
  • lpszSecondName[MAX_LENGTH_PHONEBOOKENTRYTEXT]
    Second text field associated with the entry.
  • dwIndex
    Index of the entry.
  • fHidden
    Indicates a hidden entry.
  • dwGroupIdCount
    Count of valid group ID's.
  • rgdwGroupId[MAX_NUM_GROUPS]
    Array of group ID's.
  • dwUid
    Unique identifier of entry.
  • dwAdditionalNumberCount
    Number of additional numbers in the array.
  • lpAdditionalNumbers
    Pointer to an array of SIMPHONEBOOKADDITIONALNUMBER structures.
  • dwEmailCount
    Number of email addresses in the array.
  • lpEmailAddresses
    Pointer to an array of SIMPHONEBOOKEMAILADDRESS structures.

Requirements

Header simmgr.h

See Also

Reference

SimReadPhonebookEntries
SimWritePhonebookEntryEx