|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
This code sets the protocol to be used with the currently inserted card.
SCARD_PROTOCOL_DEFAULT and SCODE_PROTOCOL_OPTIMAL are not protocols themselves, but instead instruct the driver either to explicitly perform protocol selection with the best possible communication parameters or to use the implicit protocol of the card with standard parameters. If the card supports only one protocol with one set of communication parameters, pBufInis ignored.
One of the following status values:
|STATUS_SUCCESS||One protocol has been successfully selected.|
|STATUS_NO_MEDIA||There is no smart card in the card reader.|
|STATUS_IO_TIMEOUT||The operation has timed out.|
|STATUS_NOT_SUPPORTED||The smart card does not support any of the requested protocols.|
|STATUS_INVALID_DEVICE_REQUEST||The mask contains no known protocol.|
Note: Smart card reader drivers return Windows NT status values, rather than Win32 error values, as the return values from the driver's callback function.
Last updated on Tuesday, July 13, 2004