NHTTP_AddPostDataRaw

構文


#include <nitroWiFi/nhttp.h>

int NHTTP_AddPostDataRaw( NHTTPConnectionHandle handle, const void* value, u32 length );

引数

handle NHTTP_CreateConnection()で生成した接続ハンドル
value 送信すべきHTTPリクエストPOSTデータへのポインタ
送信すべきデータをこの場で用意しない場合にはNULLを指定することもできます。その場合、 必要に応じてNHTTP_EVENT_POST_SENDコールバックが通知されますので、 その場で適切に応答する必要があります。
このポインタの指す先は接続ハンドルが解放されるまでライブラリ内部で参照される点に注意してください。
length valueの長さ(Byte単位)

返り値

POST項目の追加に成功すれば0を、
接続ハンドルがNULLの場合、
NHTTP_AddPostDataAscii()およびNHTTP_AddPostDataBinary()を既に接続ハンドルに設定した場合、
NHTTP_StartConnection()で通信処理を開始した接続ハンドルに設定しようとした場合、
内部処理でリスト要素追加時にメモリ確保に失敗した場合に失敗し-1を返します。

説明

送信すべきHTTPリクエストPOST項目全体を1個のバイナリデータとして直接設定します。
この関数は、NHTTP_AddPostDataAscii()およびNHTTP_AddPostDataBinary()と 併用することはできません。

参照

NHTTPConnectionCallback, NHTTP_AddPostDataAscii, NHTTP_AddPostDataBinary, NHTTP_StartConnection

履歴

2007/05/21 返り値を追記。
2006/10/30 記述ミスを修正。
2006/10/19 引数に関する注意事項など、説明を追記。
2006/9/25 初版。