#include <cafe.h> #include <cafe/nssl/nsslclient.h> NSSL_RVAL NSSLRead(NSSLConnectionHandle connection, void* pBuf, int len, int* pBytesRead);
|connection||A handle to a SSL connection from which to read.|
|pBuf||Buffer to read into. The buffer size and address should be aligned to
|len||Number of bytes to read.|
|pBytesRead||A pointer to hold the count of bytes read.|
||The SSL connection has been closed.|
||(Only applicable for
non-blocking connections) The operation did
not complete; the same NSSL I/O function should be
called again later. If, by then, the underlying socket has
data available for reading (if the result code is
||Some IO error occurred on the underlying socket.|
||A failure in the SSL library occurred.|
Reads from the SSL connection. The count of bytes read is written into pBytesRead when completed.
NSSLRead must read an entire record from the underlying socket before it can decrypt it and return it to the application.
NSSLRead may return only a portion of a single record but will never return portions of two different records.
NSSLGetPending returns more than zero,
NSSLRead will return at least a portion of the record and will not read additional data from the socket.
NSSLGetPending returns zero,
NSSLRead has finished giving the current record to the application and may (but not necessarily) read additional data from the underlying socket at its next call.
|Callbacks||Do not call this function from any callback function.|
|Interrupt handler||Do not call this function from any interrupt handler.|
|Exception handler||Do not call this function from any exception handler.|
2012/08/16 Cleanup pass.
2012/04/06 Initial version.