SCardSetAttrib
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
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.