ISCardFileAccess interface

[The ISCardFileAccess interface is available for use in the operating systems specified in the Requirements section. It is not available for use in Windows Server 2003 with Service Pack 1 (SP1) and later, Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The Smart Card Modules provide similar functionality.]

The following interface definition is provided as a standard that can be followed when developing a smart card service provider.

The ISCardFileAccess interface can be used to implement a high-level interface to a card-based file system with an underlying card file system based on the structure defined in ISO/IEC 7816-4. Other implementations are possible, but this is expected to be the most common.

The ISCardFileAccess interface can be used to expose file system entities in a manner very familiar to application developers in the PC environment. It provides mechanisms for locating specific files and performing common operations such as selecting, reading, writing, creating and deleting. It encapsulates and masks much of the low-level detail involved in performing these operations at the card level.

Following is a typical use of the ISCardFileAccess interface. In this case, the ISCardFileAccess interface is used to select, open, and write to a file.

Aa376153.wedge(en-us,VS.85).gifTo write to a file

  1. Call ISCardManage::CreateFileAccess to create an ISCardFileAccess interface.
  2. Call Open to select and open the file.
  3. Call Write.
  4. Call Close.
  5. Release the ISCardFileAccess interface.

Members

The ISCardFileAccess interface inherits from the IDispatch interface. ISCardFileAccess also has these types of members:

Methods

The ISCardFileAccess interface has these methods.

MethodDescription
ChangeDir

Changes the current smart card directory to the new specified directory.

Close

Closes the specified file.

Create

Creates a file at a given location within the ICC file system.

Delete

Deletes a specified file.

Directory

Retrieves a list of files.

GetCurrentDir

Returns an absolute path to the currently selected directory.

GetFileCapabilities

Retrieves file capabilities.

GetProperties

Retrieves the primitive data referred by tags for the specified object.

Invalidate

Makes the specified file not valid.

Open

Opens the specified file for further use.

Read

Reads and returns the specified data from a given file.

Rehabilitate

Makes a file (EF or DF), which has been previously made not valid by using the Invalidate command, accessible by the application.

Seek

Selects the object from which read/write permission will be done.

SetProperties

Sets the primitive data referred by tags for the specified object.

Write

Writes data to a current opened file.

 

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

 

 

Show: