SCardSetAttrib

  • Article

This function sets the specified reader attribute for the specified handle. It does not affect the state of the reader, reader driver, or smart card. Not all attributes are supported by all readers nor can they be set at all times, as many of the attributes are under direct control of the transport protocol.

LONG SCardSetAttrib(
IN SCARDHANDLE hCard, 
IN dwAttrId, 
IN LPCBYTE pbAttr, 
IN DWORD cbAttrLen );

Parameters

  • hCard
    Handle to the reference value returned from SCardConnect.
  • dwAttrId
    Specifies the identifier for the attribute to get.
  • pbAttr
    Pointer to a buffer that supplies the attribute whose identifier is supplied in dwAttrId.
  • cbAttrLen
    Count of bytes that represent the length of the attribute value in the pbAttr buffer.

Return Values

Value Description
Succeeds SCARD_S_SUCCESS
Fails An error value (see Smart Card Error values for a list of all error values)

Remarks

SCardSetAttrib is a direct card access function.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 and later Winscard.h   Winscard.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

SCardConnect, SCardGetAttrib

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.