Gemalto Prox–DU - Page 70

PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 70/129
SCARD_ATTR_PROTOCOL_TYPES: DWORD encoded as 0x0rrrpppp where rrr is
RFU and should be 0x000. pppp encodes the supported protocol types. A '1' in a
given bit position indicates support for the associated ISO protocol, so if bits zero
and one are set, both T=0 and T=1 protocols are supported.
SCARD_ATTR_VENDOR_IFD_SERIAL_NO: Vendor-supplied interface device
serial number.
SCARD_ATTR_VENDOR_IFD_TYPE: Vendor-supplied interface device type
(model designation of reader).
SCARD_ATTR_VENDOR_IFD_VERSION: Vendor-supplied interface device
version (DWORD in the form 0xMMmmbbbb where MM = major version, mm =
minor version, and bbbb = build number).
SCARD_ATTR_VENDOR_NAME: Vendor name.
pbAttr [out]
Pointer to a buffer that receives the attribute whose ID is supplied in dwAttrId. If this
value is NULL, SCardGetAttrib ignores the buffer length supplied in pcbAttrLen,
writes the length of the buffer that would have been returned if this parameter had
not been NULL to pcbAttrLen, and returns a success code.
pcbAttrLen [in, out]
Length of the pbAttr buffer in bytes, and receives the actual length of the received
attribute If the buffer length is specified as SCARD_AUTOALLOCATE, then pbAttr
is converted to a pointer to a byte pointer, and receives the address of a block of
memory containing the attribute. This block of memory must be deallocated with
SCardFreeMemory.
Return Value:
This function returns different values depending on whether it succeeds or fails:
Success: SCARD_S_SUCCESS.
Attribute value not supported: ERROR_NOT_SUPPORTED.
Other Failure: An error code. For more information, see Smart Card Return Values.
Remarks:
The SCardGetAttrib function is a direct card access function. For more information on other
direct access functions, see Direct Card Access Functions.
Examples:
The following example shows how to retrieve an attribute for a card reader. The example
assumes that hCardHandle is a valid handle obtained from a previous call to the
SCardConnect function.
LPBYTE pbAttr = NULL;
DWORD cByte = SCARD_AUTOALLOCATE;
DWORD i;
LONG lReturn;
lReturn = SCardGetAttrib(hCardHandle,
SCARD_ATTR_VENDOR_NAME,
(LPBYTE)&pbAttr,
&cByte);
if ( SCARD_S_SUCCESS != lReturn )