NHTTP_StartConnection

構文


#include <nitroWiFi/nhttp.h>

NHTTPError NHTTP_StartConnection(NHTTPConnectionHandle handle);

引数

handle NHTTP_CreateConnection()で生成した接続ハンドル

返り値

正常に通信準備が完了すればNHTTP_ERROR_NONEを、
失敗すればNHTTPError型のいずれかのエラー値を返します。

説明

接続ハンドルに設定されたリクエスト内容を使用して通信処理を開始します。 この関数が成功すると、接続ハンドルはライブラリ内部の通信準備リストへ追加されます。 ライブラリ内部のスレッドはこのリストの先頭から1個ずつ取得してHTTP通信を実行します。

通信処理が完了するまで、NHTTP_GetConnectionError()NHTTP_ERROR_BUSYを返します。
通信処理をキャンセルしたい場合はNHTTP_CancelConnection()を使用します。 通信完了までその場で待機したい場合はNHTTP_WaitForConnection()を使用します。

すでにこの関数で通信処理を開始されている場合は、何も行いません。

参照

NHTTP_CreateConnection, NHTTP_CancelConnection, NHTTP_WaitForConnection, NHTTP_GetConnectionError

履歴

2006/10/14 初版