Visit Mozilla.org

NPN DestroyStream

From MDC

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

Contents

[edit] Summary

Closes and deletes a stream.

[edit] Syntax

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

[edit] Parameters

The function has the following parameters:

instance
Pointer to current plug-in instance.
stream
Pointer to current stream, initiated by either the browser or the plug-in.
reason
Reason the stream was stopped so the application can give the user appropriate feedback. Values:
  • NPRES_DONE (most common): Stream completed normally; all data was sent by the plug-in to the browser.
  • NPRES_USER_BREAK: Plug-in is terminating the stream due to a user request.
  • NPRES_NETWORK_ERR: Stream failed due to network problems.

[edit] Returns

  • If successful, the function returns NPERR_NO_ERROR.
  • If unsuccessful, the plug-in is not loaded and the function returns an error code. For possible values, see Error Codes.

[edit] Description

The plug-in calls the NPN_DestroyStream function to close and delete a stream. This stream can be either a stream that the browser created and passed to the plug-in in NPP_NewStream, or a stream created by the plug-in through a call to NPN_NewStream.

[edit] See Also

NPP_DestroyStream, NPN_NewStream, NPStream, NPP