IFDHGetCapabilities

- get IFD capabilities

Synopsis

#include <smartcard/ifdhandler.h>

RESPONSECODE IFDHGetCapabilities(DWORD Lun, DWORD Tag,
     PDWORD Length, PUCHAR Value);

Parameters

The IFDHGetCapabilities() function takes the following parameters:

Input

Lun

Logical Unit Number

Tag

Tag of the desired data value

Length

Maximum length of the desired data value

Output

Length

Length of the data returned

Value

Value of the desired data

Description

The IFDHGetCapabilities() function retrieves the terminal or card capabilities for the terminal or card specified by Lun.

The Tag parameter can have one of the following values:

TAG_IFD_ATR

Return the ATR (Answer To Reset). This is the default value.

TAG_IFD_SIMULTANEOUS_ACCESS

Return the number of sessions the driver can handle. This value is used for multiple terminals sharing the same IFD handler.

TAG_IFD_SLOTS_NUMBER

Return the number of slots in this terminal.

If the TAG_IFD_SIMULTANEOUS_ACCESS and TAG_IFD_SLOTS_NUMBER tags are not supported, the error value IFD_ERROR_TAG must be returned.

Return Values

The following values are returned:

IFD_SUCCESS

Successful completion.

IFD_ERROR_TAG

An error occurred.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

IFDHCreateChannelByName(3SMARTCARD), attributes(5)

Notes

This manual page is derived from the MUSCLE PC/SC IFD Driver Developer Kit documentation. License terms and attribution and copyright information for this interface are available at the default location /var/sadm/pkg/SUNWocfh/install/copyright. If the Solaris Operating Environment has been installed anywhere other than the default location, modify the path to access the file at the installed location.