NPP DestroyStream

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

概要

ストリームが閉じられ、あるいは破棄されようとしているとプラグインに告知します。

文法

#include <npapi.h>
 
NPError NPP_DestroyStream(NPP       instance, 
                           NPStream* stream, 
                           NPReason  reason);

パラメータ

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

instance
現在のインスタンスへのポインタ。
stream
現在のストリームへのポインタ。
reason
ストリームが破棄された理由。 値:
  • NPRES_DONE (最も一般的): 正常終了; すべてのデータはインスタンスに送られました。
  • NPRES_USER_BREAK: 中止ボタンを押して直接的に、あるいはインスタンスを削除したり高優先度のネットワーク操作を初期化するなどして間接的に、ユーザがストリームを取り消しました。
  • NPRES_NETWORK_ERR: ネットワークやディスク I/O の問題、メモリ不足、その他の問題でストリームが失敗しました。

戻り値

  • 成功すれば、この関数は NPERR_NO_ERROR を返します。
  • 失敗すれば、プラグインは読み込まれず、この関数はエラーコードを返します。取りうる値については、エラーコードを参照してください。

説明

プラグインが正常終了するか不正終了するかしてプラグインが終了したときに、ブラウザは NPP_DestroyStream 関数を呼びます。この後に、ブラウザは NPStream オブジェクトを削除します。

このときに stream->pdata に割り当てたプライベートなデータをすべて削除すべきで、このストリームオブジェクトへのそれ以上の参照を作成するべきではありません。

関連項目

NPP_NewStream, NPStream

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

タグ: 
最終更新者: Nog,