Edit

ISCardFileAccess interface

  • Article

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

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

Method Description
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

Requirement Value
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