nn::http::Connection::SendPostDataRaw Member Function

Syntax

nn::Result SendPostDataRaw(
     const void * pValue,
     size_t valueSize
);

Arguments

Name Description
in pValue Data content.
in valueSize Data size of pValue.

Return Values

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


Value Description
Result::IsSuccess Process was successful.
ResultSocketKeepAliveDisconnected Error indicating that the server disconnected the keep-alive connection. The HTTP library usually reconnects automatically in such cases, but if set to the SetLazyPostDataSetting mode, the HTTP library does not automatically reconnect to resend POST data and instead returns this error. To reconnect, first call the Connection object's Finalize function and then call Initialize again.
ResultSocketSendErr Error indicating failure to send socket data. This could be because the server disconnected. To reconnect, first call the Connection object's Finalize function and then call Initialize again.
ResultSocketConnectErr Error indicating failure to connect to socket. This could be because the server does not exist or is not running. To reconnect, first call the Connection object's Finalize function and then call Initialize again.
ResultDnsResolutionErr Error indicating that name resolution failed for the host name specified in the URL.
ResultConnectionCanceledErr Error indicating that the connection was canceled. To reconnect, first call the Connection object's Finalize function and then call Initialize again.
ResultSslErr Error indicating that SSL processing (such as an SSL handshake) failed. You can use the GetSslError function to get more detailed error information. To reconnect, first call the Connection object's Finalize function and then call Initialize again.
ResultConnectionStatusErr Error indicating an invalid state. This function cannot be called in the current communication state. (For example, the function returns this error if the system is not yet connected. You must call this function after calling Connect.)
ResultNotConnectedErr Error indicating that no target URL was assigned to the Connection object. 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 this library's functions can be used until you first call nn::http::Initialize.
A value other than the above. Unexpected error. (See http_Result.h for details.)

Description

Function used to set POST data (as raw data) in "lazy" (delayed) POST data configuration mode.

In "lazy" POST data configuration mode, which can be entered by calling SetLazyPostDataSetting, this function can be used after either Connect or ConnectAsync is called. For more information about "lazy" POST data configuration mode, see the description of the SetLazyPostDataSetting function.

Note: Unlike the version of SendPostDataRaw that includes a timeout, this function does not time out. In other words, control will not return from this function until processing has ended. In environments where communications are slow you can expect a long time to pass before processing ends and control returns from this function.

Revision History

2010/06/14
Initial version.

CONFIDENTIAL