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.
To write to a file
- Call ISCardManage::CreateFileAccess to create an ISCardFileAccess interface.
- Call Open to select and open the file.
- Call Write.
- Call Close.
- 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 |