<div dir="ltr"><div style="font-size:12.8px">Hello all,</div><div style="font-size:12.8px"><br></div><div style="font-size:12.8px"><br></div><span style="font-size:12.8px">Several improvement suggestions for the PC/SC-Lite API documentation:</span><div style="font-size:12.8px"><br></div><div style="font-size:12.8px">* SCardGetStatusChange: Indicate that the return code SCARD_E_CANCELLED is possible.<div><br>* SCardEstablishContext: the mentioned SCARD_SCOPE_GLOBAL value of the dwScope argument is not defined in any public header file.<br></div><div><br></div><div>* SCardStatus:<span style="white-space:pre-wrap"> 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 </span>pcchReaderLen argument also says "multistring".<br><br></div><div>* SCardTransmit: the pioSendPci argument is marked as [in,out], while actually it's an input-only argument (it's even a pointer-to-const).<br><br></div><div>* 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).<br><br></div><div>* 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.</div><div><br></div><div><br></div><div>Regards,</div><div>Maksim</div></div></div>