NPP URLNotify

« Gecko Plugin API Reference « Plug-in Side Plug-in API

概要

URL リクエストの完了をインスタンスに通知します。

文法

#include <npapi.h>
 
void NPP_URLNotify(NPP         instance, 
                   const char* url,
                   NPReason    reason, 
                   void*       notifyData);

パラメータ

この関数は以下のパラメータを取ります:

instance
現在のプラグインのインスタンスへのポインタ。
url
NPN_GetURLNotifyNPN_PostURLNotify のリクエストの URL。
reason
リクエストの完了に対する理由コード。 値:
  • NPRES_DONE (最も一般的): 正常終了。
  • NPRES_USER_BREAK: 中止ボタンを押して直接的に、あるいはインスタンスを削除したり高優先度のネットワーク操作を初期化するなどして間接的に、ユーザがストリームを取り消しました。
  • NPRES_NETWORK_ERR: ネットワークやディスク I/O の問題、メモリ不足、その他の問題でストリームが失敗しました。
notifyData
前の NPN_GetURLNotifyNPN_PostURLNotify のリクエストを次の NPP_URLNotify の呼び出しと結びつけるためのプラグインのプライベートな値。

説明

NPN_GetURLNotifyNPN_PostURLNotify のリクエストが完了した後で要求は完了しその完了に対する理由コードが提供されたことをプラグインに通知するためにブラウザは NPP_URLNotify を呼びます

最も一般的な理由コードは NPRES_DONE であり、単にリクエストが正常終了したことを表します。他のありうる理由コードはユーザの行動(例えば、中止ボタンのクリック)によってリクエストが中止されたことを表す NPRES_USER_BREAK や、おそらく URL を見つけられなかったために、リクエストを完了させることができなかったことを表す NPRES_NETWORK_ERR です。

パラメータ notifyData は前の NPN_GetURLNotifyNPN_PostURLNotify の呼び出しによって引数として渡されるプラグインのプライベートな値であり、リクエストに対する識別子として使えます。

関連項目

NPN_GetURLNotify, NPN_GetURL, NPN_PostURLNotify, NPN_PostURL

ドキュメントのタグと貢献者

最終更新者: Nog,