NHTTP_GetHeaderAll

構文


#include <nitroWiFi/nhttp.h>

int NHTTP_GetHeaderAll( NHTTPConnectionHandle handle, char** value );

引数

handle NHTTP_CreateConnection()で生成した接続ハンドル
value 取得結果のアドレスを格納するためのポインタへのポインタ。
返されたポインタが指す先を変更することはできません。

返り値

HTTPレスポンスヘッダ全体が正しく取得できればその値の文字数を返します。
そうでない場合は負の値を返します。

説明

接続ハンドルのHTTPレスポンスヘッダ全体を文字列で取得します。

この関数は、実際に通信が行われHTTPレスポンスヘッダを全て受信したあとに限り使用することが出来ます。
NHTTP_GetConnectionStatus()NHTTP_STATUS_RECEIVING_BODY以降を返す状態が それに該当します。

参照

NHTTP_STATUS_RECEIVING_BODY,
NHTTP_GetHeaderField, NHTTP_StartConnection, NHTTP_GetConnectionStatus

履歴

2006/10/19 引数に関する注意事項など、説明を追記。
2006/6/26 初版。