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
Result::IsSuccess	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. No action is performed because the Connection object has not been initialized by a successful call of 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.

If the reading is successful, the value of the nn::Result::IsSuccess function is returned. ResultSocketZeroReturn is returned if this function is called when all data has already been read.

2010/06/14

Initial version.