nn::ssl::Connection::Peek Member Function

nn::Result Peek(
     u8 * pDataBuf,
     size_t dataBufSize,
     size_t * pReadSizeCourier = NULL
);

	Name	Description
out	pDataBuf	Buffer storing the data.
in	dataBufSize	Size of pDataBuf.
out	pReadSizeCourier	Buffer storing the size of data already read. (May be omitted if the size of data already read is not needed.)

Returns the function's execution result. Returns one of the Result values listed below.

Value	Description
ResultSuccess	Process was successful.
ResultSocketZeroReturn	Indicates that the receive function (nn::socket::Read, etc.) returned 0. Returned if the SSL connection was closed by the server. This can occur, for example, when all data has been read.
ResultIpcSessionErr	Error indicating an uninitialized connection. The function has not done anything as it has been called on a Connection instance for which you have not yet successfully called Initialize.
ResultNotInitializedErr	Error indicating that the library is not initialized. None of the functions in this library can be run without first running nn::ssl::Initialize.
A value other than the above.	Failed for a reason other than those listed above. (The content of the error is the same as the nn::ssl::Connection::Read function with no arguments.)

Reads ahead in data received via SSL without changing the data's state.

ResultSuccess is returned upon successful reads. ResultSocketZeroReturn is returned if this function is called when all data has already been read.

2010/06/14

Initial version.