SimWriteRecord

A version of this page is also available for

Windows Embedded CE 6.0 R3

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.

Syntax

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

Parameters

• 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.

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.

Remarks

This is a privileged function.

Requirements

See Also

Reference

SIMRECORDINFO