[Pcsclite-muscle] API Docs improvement

[Ludovic Rousseau]

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
> SCARD_AUTOALLOCATE.
>

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>