[Pcsclite-muscle] API Docs improvement

Ludovic Rousseau ludovic.rousseau
Fri Mar 11 01:34:25 PST 2016

2016-03-09 18:47 GMT+01:00 Maksim Ivanov <emaxx at google.com>:

> Hello all,

Hello Maksim,

> Several improvement suggestions for the PC/SC-Lite API documentation:
> * SCardGetStatusChange: Indicate that the return code SCARD_E_CANCELLED is
> possible.

Fixed in f590a950283ca46cb0f3e8b3a640254c61f31ff2

> * SCardEstablishContext: the mentioned SCARD_SCOPE_GLOBAL value of the
> dwScope argument is not defined in any public header file.

Fixed in  a9dbb3c3ca1527228711f3e6c61fee15a1a80971

> * SCardStatus: There is some mess regarding whether the reader name is a
> multi-string or a simple string: the argument mszReaderName is sometimes
> referred as szReaderName; the documentation of the pcchReaderLen argument
> also says "multistring".

Fixed in  2a80f615fc5084838a9c299609fa468772fae71b

> * SCardTransmit: the pioSendPci argument is marked as [in,out], while
> actually it's an input-only argument (it's even a pointer-to-const).

Fixed in  bfc6c15ec7b5941efaa48a1c1e5ff7d2cd8b0fa4

> * SCardTransmit: the example code passes a pointer to
> uninitialized SCARD_IO_REQUEST structure as the pioRecvPci argument value -
> while it's an in-out argument (and the SCardTransmit implementation
> actually reads data from it).

Fixed in  aed8486d13da8de4a77b620e28c617cc9cb18cd9

> * SCardListReaderGroups: It is stated that SCARD_E_INVALID_PARAMETER is
> returned when the mszGroups argument value is NULL, while it doesn't
> mention that this only happens when *pcchGroups is equal to

Fixed in  43bac6981940ae3e8f05122342df6515aacb7fe8

Thanks. Great work.

 Dr. Ludovic Rousseau
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.alioth.debian.org/pipermail/pcsclite-muscle/attachments/20160311/2eb97dae/attachment.html>

More information about the pcsclite-muscle mailing list