SimWriteRecord

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

The SimWriteRecord function writes a file to the SIM. This function is part of the SIM Manager API set that enables access to information stored on the SIM card.


HRESULT SimWriteRecord (
  HSIM hSim,
  DWORD dwAddress,
  DWORD dwRecordType,
  DWORD dwIndex,
  LPBYTE lpData,
  DWORD dwByteCount
);

hSim

Points to a valid HSIM handle.

dwAddress

SIM address.

dwRecordType

A SIM_RECORDTYPE constant.

Value Description

SIM_RECORDTYPE_UNKNOWN

An unknown file type.

SIM_RECORDTYPE_TRANSPARENT

A single variable-length record.

SIM_RECORDTYPE_CYCLIC

A cyclic set of records, each of the same length.

SIM_RECORDTYPE_LINEAR

A linear set of records, each of the same length.

SIM_RECORDTYPE_MASTER

Every SIM has a single master record, effectively the head node.

SIM_RECORDTYPE_DEDICATED

Effectively a "directory" file that is a parent of other records.

dwIndex

Applies only to the SIM_RECORDTYPE_CYCLIC and SIM_RECORDTYPE_LINEAR constants; this parameter is ignored in any other case.

lpData

Data to write.

dwByteCount

Number of bytes to write.

HRESULTs are either S_OK for success, or one of the SIM_E error constants defined in the SIM Manager Error Constants table.

This is a privileged function.

Headersimmgr.h
Librarycellcore.lib
Windows Embedded CEWindows Embedded CE 6.0 and later
Windows MobilePocket PC 2002 and later, Smartphone 2002 and later

Community Additions

Show: