NHTTP_SetProxy

構文


#include <nitroWiFi/nhttp.h>

int NHTTP_SetProxy( NHTTPConnectionHandle handle, const char* proxy, int port, const char* username, const char* password);

引数

handle NHTTP_CreateConnection()で生成した接続ハンドル
proxy proxyサーバのアドレスを示すURL文字列(256文字まで)
port proxyサーバのポート番号
username proxyサーバに対するBasic認証のユーザ名(32文字まで)
不要な場合はNULLを指定します。
password proxyサーバに対するBasic認証のパスワード(32文字まで)
不要な場合はNULLを指定します。

返り値

proxyサーバの設定に成功すれば0を、
接続ハンドルがNULLの場合、
proxyサーバのアドレスがNULLまたは256文字を超える場合、
Basic認証のユーザー名、パスワードが32文字を超える場合に失敗し-1を返します。

説明

送信すべきHTTPリクエストに使用するproxyサーバを設定します。
対象となるproxyサーバがBasic認証を必要とする場合、そのユーザ名とパスワードもあわせて設定します。

これらの設定内容は、NHTTP_StartConnection()呼び出し後の 実際の接続時にライブラリ内部で適切に処理されます。

参照

NHTTP_StartConnection

履歴

2007/05/21 返り値を追記。
2006/10/19 説明を追記。
2006/8/3 初版。