Share via

SimReadPhonebookTag (Windows Embedded CE 6.0)

  • Article

1/6/2010

The SimReadPhonebookTag reads the name value for a given index and tag. This function is part of the SIM Manager API set that enables access to information stored on the USIM card.

Syntax

HRESULT SimReadPhonebookTag(
  HSIM hSim,
  DWORD dwTag,
  DWORD dwIndex,
    __out_ecount(cchNameSize) LPTSTR szName,
    DWORD cchNameSize
);

Parameters

  • hSim
    Points to a valid HSIM handle.

  • dwTag
    A SIM_PBTAG_* constant

    Value Description

    SIM_PBTAG_GROUP

    Group name tag

    SIM_PBTAG_NUMBER

    Additional Number tag
  • dwIndex
    Index of the tag to read.
  • szName
    Returned name of tag.
  • cchNameSize
    Size of name in characters.

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.

Requirements

Header simmgr.h
Library cellcore.lib

See Also

Reference

SimWritePhonebookTag

Concepts

SIM Manager Functions