ネットワーク関数

ConnectLine
DisconnectLine
GetHTTP
isOnline
OpenWeb
StartUpdate
ThrowHTTP

int ConnectLine( )

機能 ダイヤルアップ回線を接続します.
引数

なし

戻り値
1成功
0失敗
-1関数使用権限が無い
説明

ダイヤルアップ回線を接続します. ダイアルアップ先は, Chararinaの「インターネット接続」設定に従います.

このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧

int DisconnectLine( )

機能 ダイヤルアップ回線を切断します.
引数

なし

戻り値
1成功
0失敗
-1関数使用権限が無い
説明

現在接続されているダイヤルアップ回線を切断します.

このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧

string GetHTTP(
  string URL,
  string str,
  int method,
  int timeout )

機能 URLにアクセスしてその内容を返します.
引数
URL アクセスするURL
str 送信する文字列
method 送信方法
timeout タイムアウト時間[ms]
戻り値
URLの内容受信したデータ
"-1" 関数の使用許可がない
説明

URL引数で指定されたURLにアクセスし,その内容を文字列の形で返します.

str引数に送信する文字列を指定します. GETまたはPOSTメソッドで送信したい文字列を指定します. 文字列は送信可能な形式に自動的にエンコードされます.

method引数の詳細はThrowHTTPを参照してください.

timeout引数にタイムアウトを指定します.単位はミリ秒です. timeout引数で指定した時間を過ぎても応答が無い場合は, タイムアウト処理を行います.

例1
第二引数strに指定する場合は,自動でエンコードされます.
下の二つの例は,同じ処理になります.
(GETメソッドの場合) 
GetHTTP( "http://www.praesens.co.jp/foo.cgi?str1=HOGE?str2=meke", "", 0, 9000 );
GetHTTP( "http://www.praesens.co.jp/foo.cgi", "str1=HOGE&str2=meke", 0, 9000 );

URL引数に"?str="形式でパラメータを記述し,同時に引数strにパラメータを
指定された場合の動作は保証されません.

(1.01以降)Ver.1.01から,SJIS以外の文字コードのファイルに対しても自動変
換し, SJISコードとして取得できるよう拡張されました.変換の対象となる
文字コードは基本的に自動判別されますが, 希にごく短いテキスト等で変換
に失敗する場合があります.この場合, プロパティで変換元の文字コードを
指定します.サポートしている文字コードは次のとおりです,"SJIS","EUC","JIS",
"UTF-8"(BOMありorBOMなし)
このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧

int isOnline( )

機能 インターネット接続している状態か否かをチェックします.
引数

なし

戻り値
1接続
0非接続
説明

インターネット接続状態を検知します.

ダイヤルアップルータ等の回線を自動接続するタイプの装置を使用している環境の場合, この関数を呼びだすことでルータが電話発呼動作を行う場合があります.

このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧

int OpenWeb(   string URL )

機能 URLを標準WEBブラウザを開きます.
引数
URL 開くURL
戻り値
0成功
-1関数使用権限が無い
説明

URL引数で指定されたURLを,標準設定のWWWブラウザを使って開きます.

このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧

int StartUpdate( )[3.00以降]

機能キャラクターの更新を開始します.
引数

なし

戻り値
1成功
-1失敗(関数使用権限が無い)
-2失敗(psnファイルに更新URLが定義されていない)
説明

キャラクターの右クリックメニューから,[更新]を選択した場合と同じ処理を行います.
この関数を実行するためには,ユーザから関数使用権限を与えられていなければなりません.
この関数使用権限は設定ダイアログ中の権限に関する設定の中で変更できます.

この関数の動作に関して,以下の注意事項があります.

  • インターネットへの接続にダイアルアップを行なう環境では, 権限設定「ダイヤルアップ回線の接続」の設定の如何にかかわらず ダイヤルアップを行います.
  • 更新作業中にエラーが発生した場合, エラーダイアログが表示されることがあります. キャラクターからこのエラーダイアログを操作することはできません.
  • 他キャラクターの相乗り更新が設定されていた場合は, 設定にしたがって相乗り更新を行ないます.

このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧

int ThrowHTTP(
  string URL,
  string str,
  int method )

機能 GETまたはPOSTメソッドでURLにアクセスします.
引数
URL アクセスするURL
str 送信する文字列
method 送信方法
戻り値
-1関数使用権限が無い
1その他
説明

URL引数で指定されるURLにアクセスします.

str引数に送信する文字列を指定します. GETまたはPOSTメソッドを使って送信したい文字列をstr引数に指定します. 文字列は自動的に送信可能な形式にエンコードされます.

str引数を送信する方法を,method引数で指定します.

method
0GET
1POST

ThrowHTTP関数はURLへアクセスを開始してすぐに関数を終了します. したがってアクセスの成功失敗を取得することはできません.

例1
        下の二つの例は,同じ処理になります.
        (GETメソッドの場合) 
        ThrowHTTP( "\a(http://www.praesens.co.jp/foo.cgi?str1=HOGE?str2=meke)\_a", "", 0 );
        ThrowHTTP( "\a(http://www.praesens.co.jp/foo.cgi)\_a", "str1=HOGE&str2=meke", 0 );
      
このカテゴリのトップ| カテゴリ別関数一覧| 関数名一覧