win/include/xpcom/nsICrashReporter.h - chromium/deps/xulrunner-sdk - Git at Google

 /*
  * DO NOT EDIT.  THIS FILE IS GENERATED FROM e:/builds/tinderbox/XR-Trunk/WINNT_5.2_Depend/mozilla/xpcom/system/nsICrashReporter.idl
  */

 #ifndef __gen_nsICrashReporter_h__
 #define __gen_nsICrashReporter_h__


 #ifndef __gen_nsISupports_h__
 #include "nsISupports.h"
 #endif

 /* For IDL files that don't want to include root IDL files. */
 #ifndef NS_NO_VTABLE
 #define NS_NO_VTABLE
 #endif

 /* starting interface:    nsICrashReporter */
 #define NS_ICRASHREPORTER_IID_STR "4d6449fe-d642-45e5-9773-41af5793c99a"

 #define NS_ICRASHREPORTER_IID \
   {0x4d6449fe, 0xd642, 0x45e5, \
     { 0x97, 0x73, 0x41, 0xaf, 0x57, 0x93, 0xc9, 0x9a }}

 /**
  * Provides access to crash reporting functionality.
  * @status UNSTABLE - This interface is not frozen and will probably change in
  *                    future releases.
  */
 class NS_NO_VTABLE NS_SCRIPTABLE nsICrashReporter : public nsISupports {
  public:

   NS_DECLARE_STATIC_IID_ACCESSOR(NS_ICRASHREPORTER_IID)

   /**
    * Add some extra data to be submitted with a crash report.
    * @param key
    *        Name of the data to be added.
    * @param data
    *        Data to be added.
    *
    * @throw NS_ERROR_NOT_INITIALIZED if crash reporting not initialized
    * @throw NS_ERROR_INVALID_ARG if key or data contain invalid characters.
    *                             Invalid characters for key are '=' and
    *                             '\n'.  Invalid character for data is '\0'.
    */
   /* void annotateCrashReport (in ACString key, in ACString data); */
   NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data) = 0;

   /**
     * Write a minidump immediately, with the user-supplied exception
     * information. This is implemented on Windows only, because
     * SEH (structured exception handling) exists on Windows only.
     * @param aExceptionInfo  EXCEPTION_INFO* provided by Window's SEH
     */
   /* [noscript] void WriteMinidumpForException (in voidPtr aExceptionInfo); */
   NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo) = 0;

 };

   NS_DEFINE_STATIC_IID_ACCESSOR(nsICrashReporter, NS_ICRASHREPORTER_IID)

 /* Use this macro when declaring classes that implement this interface. */
 #define NS_DECL_NSICRASHREPORTER \
   NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data); \
   NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo);

 /* Use this macro to declare functions that forward the behavior of this interface to another object. */
 #define NS_FORWARD_NSICRASHREPORTER(_to) \
   NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data) { return _to AnnotateCrashReport(key, data); } \
   NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo) { return _to WriteMinidumpForException(aExceptionInfo); }

 /* Use this macro to declare functions that forward the behavior of this interface to another object in a safe way. */
 #define NS_FORWARD_SAFE_NSICRASHREPORTER(_to) \
   NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data) { return !_to ? NS_ERROR_NULL_POINTER : _to->AnnotateCrashReport(key, data); } \
   NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo) { return !_to ? NS_ERROR_NULL_POINTER : _to->WriteMinidumpForException(aExceptionInfo); }

 #if 0
 /* Use the code below as a template for the implementation class for this interface. */

 /* Header file */
 class nsCrashReporter : public nsICrashReporter
 {
 public:
   NS_DECL_ISUPPORTS
   NS_DECL_NSICRASHREPORTER

   nsCrashReporter();

 private:
   ~nsCrashReporter();

 protected:
   /* additional members */
 };

 /* Implementation file */
 NS_IMPL_ISUPPORTS1(nsCrashReporter, nsICrashReporter)

 nsCrashReporter::nsCrashReporter()
 {
   /* member initializers and constructor code */
 }

 nsCrashReporter::~nsCrashReporter()
 {
   /* destructor code */
 }

 /* void annotateCrashReport (in ACString key, in ACString data); */
 NS_IMETHODIMP nsCrashReporter::AnnotateCrashReport(const nsACString & key, const nsACString & data)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* [noscript] void WriteMinidumpForException (in voidPtr aExceptionInfo); */
 NS_IMETHODIMP nsCrashReporter::WriteMinidumpForException(void * aExceptionInfo)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* End of implementation class template. */
 #endif


 /* starting interface:    nsICrashReporter_MOZILLA_1_9_BRANCH */
 #define NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID_STR "5d0c6cc1-e1e7-42ce-ae99-ff7b9466a909"

 #define NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID \
   {0x5d0c6cc1, 0xe1e7, 0x42ce, \
     { 0xae, 0x99, 0xff, 0x7b, 0x94, 0x66, 0xa9, 0x09 }}

 class NS_NO_VTABLE NS_SCRIPTABLE nsICrashReporter_MOZILLA_1_9_BRANCH : public nsISupports {
  public:

   NS_DECLARE_STATIC_IID_ACCESSOR(NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID)

   /**
    * Append some data to the "Notes" field, to be submitted with a crash report.
    * Unlike annotateCrashReport, this method will append to existing data.
    *
    * @param data
    *        Data to be added.
    *
    * @throw NS_ERROR_NOT_INITIALIZED if crash reporting not initialized
    * @throw NS_ERROR_INVALID_ARG if or data contains invalid characters.
    *                             The only invalid character is '\0'.
    */
   /* void appendAppNotesToCrashReport (in ACString data); */
   NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data) = 0;

   /**
     * Append note containing an Obj-C exception's info.
     * @param aException  NSException object to append note for
     */
   /* [noscript] void appendObjCExceptionInfoToAppNotes (in voidPtr aException); */
   NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException) = 0;

 };

   NS_DEFINE_STATIC_IID_ACCESSOR(nsICrashReporter_MOZILLA_1_9_BRANCH, NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID)

 /* Use this macro when declaring classes that implement this interface. */
 #define NS_DECL_NSICRASHREPORTER_MOZILLA_1_9_BRANCH \
   NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data); \
   NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException);

 /* Use this macro to declare functions that forward the behavior of this interface to another object. */
 #define NS_FORWARD_NSICRASHREPORTER_MOZILLA_1_9_BRANCH(_to) \
   NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data) { return _to AppendAppNotesToCrashReport(data); } \
   NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException) { return _to AppendObjCExceptionInfoToAppNotes(aException); }

 /* Use this macro to declare functions that forward the behavior of this interface to another object in a safe way. */
 #define NS_FORWARD_SAFE_NSICRASHREPORTER_MOZILLA_1_9_BRANCH(_to) \
   NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data) { return !_to ? NS_ERROR_NULL_POINTER : _to->AppendAppNotesToCrashReport(data); } \
   NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException) { return !_to ? NS_ERROR_NULL_POINTER : _to->AppendObjCExceptionInfoToAppNotes(aException); }

 #if 0
 /* Use the code below as a template for the implementation class for this interface. */

 /* Header file */
 class nsCrashReporter_MOZILLA_1_9_BRANCH : public nsICrashReporter_MOZILLA_1_9_BRANCH
 {
 public:
   NS_DECL_ISUPPORTS
   NS_DECL_NSICRASHREPORTER_MOZILLA_1_9_BRANCH

   nsCrashReporter_MOZILLA_1_9_BRANCH();

 private:
   ~nsCrashReporter_MOZILLA_1_9_BRANCH();

 protected:
   /* additional members */
 };

 /* Implementation file */
 NS_IMPL_ISUPPORTS1(nsCrashReporter_MOZILLA_1_9_BRANCH, nsICrashReporter_MOZILLA_1_9_BRANCH)

 nsCrashReporter_MOZILLA_1_9_BRANCH::nsCrashReporter_MOZILLA_1_9_BRANCH()
 {
   /* member initializers and constructor code */
 }

 nsCrashReporter_MOZILLA_1_9_BRANCH::~nsCrashReporter_MOZILLA_1_9_BRANCH()
 {
   /* destructor code */
 }

 /* void appendAppNotesToCrashReport (in ACString data); */
 NS_IMETHODIMP nsCrashReporter_MOZILLA_1_9_BRANCH::AppendAppNotesToCrashReport(const nsACString & data)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* [noscript] void appendObjCExceptionInfoToAppNotes (in voidPtr aException); */
 NS_IMETHODIMP nsCrashReporter_MOZILLA_1_9_BRANCH::AppendObjCExceptionInfoToAppNotes(void * aException)
 {
     return NS_ERROR_NOT_IMPLEMENTED;
 }

 /* End of implementation class template. */
 #endif


 #endif /* __gen_nsICrashReporter_h__ */
	/*
	* DO NOT EDIT. THIS FILE IS GENERATED FROM e:/builds/tinderbox/XR-Trunk/WINNT_5.2_Depend/mozilla/xpcom/system/nsICrashReporter.idl
	*/

	#ifndef __gen_nsICrashReporter_h__
	#define __gen_nsICrashReporter_h__


	#ifndef __gen_nsISupports_h__
	#include "nsISupports.h"
	#endif

	/* For IDL files that don't want to include root IDL files. */
	#ifndef NS_NO_VTABLE
	#define NS_NO_VTABLE
	#endif

	/* starting interface: nsICrashReporter */
	#define NS_ICRASHREPORTER_IID_STR "4d6449fe-d642-45e5-9773-41af5793c99a"

	#define NS_ICRASHREPORTER_IID \
	{0x4d6449fe, 0xd642, 0x45e5, \
	{ 0x97, 0x73, 0x41, 0xaf, 0x57, 0x93, 0xc9, 0x9a }}

	/**
	* Provides access to crash reporting functionality.
	* @status UNSTABLE - This interface is not frozen and will probably change in
	* future releases.
	*/
	class NS_NO_VTABLE NS_SCRIPTABLE nsICrashReporter : public nsISupports {
	public:

	NS_DECLARE_STATIC_IID_ACCESSOR(NS_ICRASHREPORTER_IID)

	/**
	* Add some extra data to be submitted with a crash report.
	* @param key
	* Name of the data to be added.
	* @param data
	* Data to be added.
	*
	* @throw NS_ERROR_NOT_INITIALIZED if crash reporting not initialized
	* @throw NS_ERROR_INVALID_ARG if key or data contain invalid characters.
	* Invalid characters for key are '=' and
	* '\n'. Invalid character for data is '\0'.
	*/
	/* void annotateCrashReport (in ACString key, in ACString data); */
	NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data) = 0;

	/**
	* Write a minidump immediately, with the user-supplied exception
	* information. This is implemented on Windows only, because
	* SEH (structured exception handling) exists on Windows only.
	* @param aExceptionInfo EXCEPTION_INFO* provided by Window's SEH
	*/
	/* [noscript] void WriteMinidumpForException (in voidPtr aExceptionInfo); */
	NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo) = 0;

	};

	NS_DEFINE_STATIC_IID_ACCESSOR(nsICrashReporter, NS_ICRASHREPORTER_IID)

	/* Use this macro when declaring classes that implement this interface. */
	#define NS_DECL_NSICRASHREPORTER \
	NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data); \
	NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo);

	/* Use this macro to declare functions that forward the behavior of this interface to another object. */
	#define NS_FORWARD_NSICRASHREPORTER(_to) \
	NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data) { return _to AnnotateCrashReport(key, data); } \
	NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo) { return _to WriteMinidumpForException(aExceptionInfo); }

	/* Use this macro to declare functions that forward the behavior of this interface to another object in a safe way. */
	#define NS_FORWARD_SAFE_NSICRASHREPORTER(_to) \
	NS_SCRIPTABLE NS_IMETHOD AnnotateCrashReport(const nsACString & key, const nsACString & data) { return !_to ? NS_ERROR_NULL_POINTER : _to->AnnotateCrashReport(key, data); } \
	NS_IMETHOD WriteMinidumpForException(void * aExceptionInfo) { return !_to ? NS_ERROR_NULL_POINTER : _to->WriteMinidumpForException(aExceptionInfo); }

	#if 0
	/* Use the code below as a template for the implementation class for this interface. */

	/* Header file */
	class nsCrashReporter : public nsICrashReporter
	{
	public:
	NS_DECL_ISUPPORTS
	NS_DECL_NSICRASHREPORTER

	nsCrashReporter();

	private:
	~nsCrashReporter();

	protected:
	/* additional members */
	};

	/* Implementation file */
	NS_IMPL_ISUPPORTS1(nsCrashReporter, nsICrashReporter)

	nsCrashReporter::nsCrashReporter()
	{
	/* member initializers and constructor code */
	}

	nsCrashReporter::~nsCrashReporter()
	{
	/* destructor code */
	}

	/* void annotateCrashReport (in ACString key, in ACString data); */
	NS_IMETHODIMP nsCrashReporter::AnnotateCrashReport(const nsACString & key, const nsACString & data)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* [noscript] void WriteMinidumpForException (in voidPtr aExceptionInfo); */
	NS_IMETHODIMP nsCrashReporter::WriteMinidumpForException(void * aExceptionInfo)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* End of implementation class template. */
	#endif


	/* starting interface: nsICrashReporter_MOZILLA_1_9_BRANCH */
	#define NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID_STR "5d0c6cc1-e1e7-42ce-ae99-ff7b9466a909"

	#define NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID \
	{0x5d0c6cc1, 0xe1e7, 0x42ce, \
	{ 0xae, 0x99, 0xff, 0x7b, 0x94, 0x66, 0xa9, 0x09 }}

	class NS_NO_VTABLE NS_SCRIPTABLE nsICrashReporter_MOZILLA_1_9_BRANCH : public nsISupports {
	public:

	NS_DECLARE_STATIC_IID_ACCESSOR(NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID)

	/**
	* Append some data to the "Notes" field, to be submitted with a crash report.
	* Unlike annotateCrashReport, this method will append to existing data.
	*
	* @param data
	* Data to be added.
	*
	* @throw NS_ERROR_NOT_INITIALIZED if crash reporting not initialized
	* @throw NS_ERROR_INVALID_ARG if or data contains invalid characters.
	* The only invalid character is '\0'.
	*/
	/* void appendAppNotesToCrashReport (in ACString data); */
	NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data) = 0;

	/**
	* Append note containing an Obj-C exception's info.
	* @param aException NSException object to append note for
	*/
	/* [noscript] void appendObjCExceptionInfoToAppNotes (in voidPtr aException); */
	NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException) = 0;

	};

	NS_DEFINE_STATIC_IID_ACCESSOR(nsICrashReporter_MOZILLA_1_9_BRANCH, NS_ICRASHREPORTER_MOZILLA_1_9_BRANCH_IID)

	/* Use this macro when declaring classes that implement this interface. */
	#define NS_DECL_NSICRASHREPORTER_MOZILLA_1_9_BRANCH \
	NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data); \
	NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException);

	/* Use this macro to declare functions that forward the behavior of this interface to another object. */
	#define NS_FORWARD_NSICRASHREPORTER_MOZILLA_1_9_BRANCH(_to) \
	NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data) { return _to AppendAppNotesToCrashReport(data); } \
	NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException) { return _to AppendObjCExceptionInfoToAppNotes(aException); }

	/* Use this macro to declare functions that forward the behavior of this interface to another object in a safe way. */
	#define NS_FORWARD_SAFE_NSICRASHREPORTER_MOZILLA_1_9_BRANCH(_to) \
	NS_SCRIPTABLE NS_IMETHOD AppendAppNotesToCrashReport(const nsACString & data) { return !_to ? NS_ERROR_NULL_POINTER : _to->AppendAppNotesToCrashReport(data); } \
	NS_IMETHOD AppendObjCExceptionInfoToAppNotes(void * aException) { return !_to ? NS_ERROR_NULL_POINTER : _to->AppendObjCExceptionInfoToAppNotes(aException); }

	#if 0
	/* Use the code below as a template for the implementation class for this interface. */

	/* Header file */
	class nsCrashReporter_MOZILLA_1_9_BRANCH : public nsICrashReporter_MOZILLA_1_9_BRANCH
	{
	public:
	NS_DECL_ISUPPORTS
	NS_DECL_NSICRASHREPORTER_MOZILLA_1_9_BRANCH

	nsCrashReporter_MOZILLA_1_9_BRANCH();

	private:
	~nsCrashReporter_MOZILLA_1_9_BRANCH();

	protected:
	/* additional members */
	};

	/* Implementation file */
	NS_IMPL_ISUPPORTS1(nsCrashReporter_MOZILLA_1_9_BRANCH, nsICrashReporter_MOZILLA_1_9_BRANCH)

	nsCrashReporter_MOZILLA_1_9_BRANCH::nsCrashReporter_MOZILLA_1_9_BRANCH()
	{
	/* member initializers and constructor code */
	}

	nsCrashReporter_MOZILLA_1_9_BRANCH::~nsCrashReporter_MOZILLA_1_9_BRANCH()
	{
	/* destructor code */
	}

	/* void appendAppNotesToCrashReport (in ACString data); */
	NS_IMETHODIMP nsCrashReporter_MOZILLA_1_9_BRANCH::AppendAppNotesToCrashReport(const nsACString & data)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* [noscript] void appendObjCExceptionInfoToAppNotes (in voidPtr aException); */
	NS_IMETHODIMP nsCrashReporter_MOZILLA_1_9_BRANCH::AppendObjCExceptionInfoToAppNotes(void * aException)
	{
	return NS_ERROR_NOT_IMPLEMENTED;
	}

	/* End of implementation class template. */
	#endif


	#endif /* __gen_nsICrashReporter_h__ */