SIMPHONEBOOKCAPS (Compact 2013)

3/26/2014

The SIMPHONEBOOKCAPS structure addresses various capabilities of the SIM phonebook. This structure is part of the SIM Manager API set that enables access to information stored on the SIM or USIM card.

Syntax

typedef struct simphonebookcaps_tag {
DWORD cbSize;
DWORD dwParams;
DWORD dwStorages;
DWORD dwMinIndex;
DWORD dwMaxIndex;
DWORD dwMaxAddressLength;
DWORD dwMaxTextLength;
DWORD dwMaxSecondNameLength;
DWORD dwMaxAdditionalNumberLength;
DWORD dwMaxEmailAddressLength;
DWORD dwMaxGroupTagLength;
DWORD dwMaxAdditionalNumberTagLength;
DWORD dwAdditionalNumberCount;
DWORD dwEmailAddressCount;
DWORD dwMaxGroupTags;
DWORD dwMaxAdditionalNumberTags;
BOOL fHidden;
BOOL fUid;
DWORD dwMaxGroupIdCount;
} SIMPHONEBOOKCAPS, FAR *LPPHONEBOOKSIMCAPS;

Members

  • cbSize
    Size of the structure in bytes.
  • dwParams
    Indicates valid parameter values.
  • dwStorages
    Supported phonebook storages.
  • dwMinIndex
    Index of minimum phonebook storages.
  • dwMaxIndex
    Index of maximum phonebook storages.
  • dwMaxAddressLength
    Maximum address length of phonebook entries.
  • dwMaxTextLength
    Maximum text length of phonebook entries.
  • dwMaxSecondNameLength
    Maximum text length for the second name.
  • dwMaxAdditionalNumberLength
    Maximum text length for additional numbers.
  • dwMaxEmailAddressLength
    Maximum text length for email addresses.
  • dwMaxGroupTagLength
    Maximum text length for group tag text.
  • dwMaxAdditionalNumberTagLength
    Maximum text length for additional number tag text.
  • dwAdditionalNumberCount
    Count of additional numbers supported per entry.
  • dwEmailAddressCount
    Number of emails addresses supported per entry.
  • dwMaxGroupTags
    Number of Group tags available.
  • dwMaxAdditionalNumberTags
    Number of additional number tags available.
  • fHidden
    Hidden flag is available.
  • fUid
    Unique identifier is available.
  • dwMaxGroupIdCount
    Number of groups supported per entry.

Remarks

The bits of the dwParams parameter have the following meanings:

Constant

Value

Description

SIM_PARAM_PBCAPS_STORAGES

0x00000001

dwStorages field is valid

SIM_PARAM_PBCAPS_MININDEX

0x00000002

dwMinIndex field is valid

SIM_PARAM_PBCAPS_MAXINDEX

0x00000004

dwMaxIndex field is valid

SIM_PARAM_PBCAPS_MAXADDRESSLENGTH

0x00000008

dwMaxAddressLength field is valid

SIM_PARAM_PBCAPS_MAXTEXTLENGTH

0x00000010

dwMaxTextLength field is valid

SIM_PARAM_PBCAPS_MAXSECONDNAMELENGTH

0x00000020

dwMaxSecondNameLength field is valid

SIM_PARAM_PBCAPS_MAXADDITIONALNUMBERLENGTH

0x00000040

dwMaxAdditionalNumberLength field is valid

SIM_PARAM_PBCAPS_MAXEMAILADDRESSLENGTH

0x00000080

dwMaxEmailAddressLength field is valid

SIM_PARAM_PBCAPS_MAXGROUPTAGLENGTH

0x00000100

dwGroupTagLength field is valid

SIM_PARAM_PBCAPS_MAXADDITIONALNUMBERTAGLENGTH

0x00000200

dwAdditionalNumberTagLength field is valid

SIM_PARAM_PBCAPS_ADDITIONALNUMBERCOUNT

0x00000400

dwAdditionalNumberCount field is valid

SIM_PARAM_PBCAPS_EMAILADDRESSCOUNT

0x00000800

dwEmailAddressCount field is valid

SIM_PARAM_PBCAPS_MAXGROUPTAGS

0x00001000

dwMaxGroupTags field is valid

SIM_PARAM_PBCAPS_MAXADDITIONALNUMBERTAGS

0x00002000

dwMaxAddtionalNumberTags field is valid

SIM_PARAM_PBCAPS_HIDDEN

0x00004000

fHidden field is valid

SIM_PARAM_PBCAPS_UID

0x00008000

fUid field is valid

SIM_PARAM_PBCAPS_MAXGROUPIDCOUNT

0x00010000

dwMaxGroupIdCount is valid

SIM_PARAM_PBCAPS_ALL

0x0001FFFF

All fields are valid

Requirements

Header

simmgr.h

See Also

Reference

SIM Manager Structures
SimGetPhonebookCapabilities