//
// DO NOT EDIT.  THIS FILE IS GENERATED FROM ../../../dist/idl/nsIWebContentConverterRegistrar.idl
//


/// `interface nsIWebContentHandlerInfo : nsIHandlerApp`
///


// The actual type definition for the interface. This struct has methods
// declared on it which will call through its vtable. You never want to pass
// this type around by value, always pass it behind a reference.

#[repr(C)]
pub struct nsIWebContentHandlerInfo {
    vtable: *const nsIWebContentHandlerInfoVTable,

    /// This field is a phantomdata to ensure that the VTable type and any
    /// struct containing it is not safe to send across threads, as XPCOM is
    /// generally not threadsafe.
    ///
    /// XPCOM interfaces in general are not safe to send across threads.
    __nosync: ::std::marker::PhantomData<::std::rc::Rc<u8>>,
}

// Implementing XpCom for an interface exposes its IID, which allows for easy
// use of the `.query_interface<T>` helper method. This also defines that
// method for nsIWebContentHandlerInfo.
unsafe impl XpCom for nsIWebContentHandlerInfo {
    const IID: nsIID = nsID(0xeb361098, 0x5158, 0x4b21,
        [0x8f, 0x98, 0x50, 0xb4, 0x45, 0xf1, 0xf0, 0xb2]);
}

// We need to implement the RefCounted trait so we can be used with `RefPtr`.
// This trait teaches `RefPtr` how to manage our memory.
unsafe impl RefCounted for nsIWebContentHandlerInfo {
    #[inline]
    unsafe fn addref(&self) {
        self.AddRef();
    }
    #[inline]
    unsafe fn release(&self) {
        self.Release();
    }
}

// This trait is implemented on all types which can be coerced to from nsIWebContentHandlerInfo.
// It is used in the implementation of `fn coerce<T>`. We hide it from the
// documentation, because it clutters it up a lot.
#[doc(hidden)]
pub trait nsIWebContentHandlerInfoCoerce {
    /// Cheaply cast a value of this type from a `nsIWebContentHandlerInfo`.
    fn coerce_from(v: &nsIWebContentHandlerInfo) -> &Self;
}

// The trivial implementation: We can obviously coerce ourselves to ourselves.
impl nsIWebContentHandlerInfoCoerce for nsIWebContentHandlerInfo {
    #[inline]
    fn coerce_from(v: &nsIWebContentHandlerInfo) -> &Self {
        v
    }
}

impl nsIWebContentHandlerInfo {
    /// Cast this `nsIWebContentHandlerInfo` to one of its base interfaces.
    #[inline]
    pub fn coerce<T: nsIWebContentHandlerInfoCoerce>(&self) -> &T {
        T::coerce_from(self)
    }
}

// Every interface struct type implements `Deref` to its base interface. This
// causes methods on the base interfaces to be directly avaliable on the
// object. For example, you can call `.AddRef` or `.QueryInterface` directly
// on any interface which inherits from `nsISupports`.
impl ::std::ops::Deref for nsIWebContentHandlerInfo {
    type Target = nsIHandlerApp;
    #[inline]
    fn deref(&self) -> &nsIHandlerApp {
        unsafe {
            ::std::mem::transmute(self)
        }
    }
}

// Ensure we can use .coerce() to cast to our base types as well. Any type which
// our base interface can coerce from should be coercable from us as well.
impl<T: nsIHandlerAppCoerce> nsIWebContentHandlerInfoCoerce for T {
    #[inline]
    fn coerce_from(v: &nsIWebContentHandlerInfo) -> &Self {
        T::coerce_from(v)
    }
}

// This struct represents the interface's VTable. A pointer to a statically
// allocated version of this struct is at the beginning of every nsIWebContentHandlerInfo
// object. It contains one pointer field for each method in the interface. In
// the case where we can't generate a binding for a method, we include a void
// pointer.
#[doc(hidden)]
#[repr(C)]
pub struct nsIWebContentHandlerInfoVTable {
    /// We need to include the members from the base interface's vtable at the start
    /// of the VTable definition.
    pub __base: nsIHandlerAppVTable,

    /* readonly attribute AString contentType; */
    pub GetContentType: unsafe extern "system" fn (this: *const nsIWebContentHandlerInfo, aContentType: &mut ::nsstring::nsAString) -> nsresult,

    /* readonly attribute AString uri; */
    pub GetUri: unsafe extern "system" fn (this: *const nsIWebContentHandlerInfo, aUri: &mut ::nsstring::nsAString) -> nsresult,

    /* AString getHandlerURI (in AString uri); */
    pub GetHandlerURI: unsafe extern "system" fn (this: *const nsIWebContentHandlerInfo, uri: &::nsstring::nsAString, _retval: &mut ::nsstring::nsAString) -> nsresult,
}


// The implementations of the function wrappers which are exposed to rust code.
// Call these methods rather than manually calling through the VTable struct.
impl nsIWebContentHandlerInfo {

    /// ```text
    /// /**
    ///    * The content type handled by the handler
    ///    */
    /// ```
    ///

    /// `readonly attribute AString contentType;`
    #[inline]
    pub unsafe fn GetContentType(&self, aContentType: &mut ::nsstring::nsAString) -> nsresult {
        ((*self.vtable).GetContentType)(self, aContentType)
    }


    /// ```text
    /// /**
    ///    * The uri of the handler, with an embedded %s where the URI of the loaded
    ///    * document will be encoded.
    ///    */
    /// ```
    ///

    /// `readonly attribute AString uri;`
    #[inline]
    pub unsafe fn GetUri(&self, aUri: &mut ::nsstring::nsAString) -> nsresult {
        ((*self.vtable).GetUri)(self, aUri)
    }


    /// ```text
    /// /**
    ///    * Gets the service URL Spec, with the loading document URI encoded in it.
    ///    * @param   uri
    ///    *          The URI of the document being loaded
    ///    * @returns The URI of the service with the loading document URI encoded in
    ///    *          it.
    ///    */
    /// ```
    ///

    /// `AString getHandlerURI (in AString uri);`
    #[inline]
    pub unsafe fn GetHandlerURI(&self, uri: &::nsstring::nsAString, _retval: &mut ::nsstring::nsAString) -> nsresult {
        ((*self.vtable).GetHandlerURI)(self, uri, _retval)
    }


}


/// `interface nsIWebContentConverterService : nsIWebContentHandlerRegistrar`
///


// The actual type definition for the interface. This struct has methods
// declared on it which will call through its vtable. You never want to pass
// this type around by value, always pass it behind a reference.

#[repr(C)]
pub struct nsIWebContentConverterService {
    vtable: *const nsIWebContentConverterServiceVTable,

    /// This field is a phantomdata to ensure that the VTable type and any
    /// struct containing it is not safe to send across threads, as XPCOM is
    /// generally not threadsafe.
    ///
    /// XPCOM interfaces in general are not safe to send across threads.
    __nosync: ::std::marker::PhantomData<::std::rc::Rc<u8>>,
}

// Implementing XpCom for an interface exposes its IID, which allows for easy
// use of the `.query_interface<T>` helper method. This also defines that
// method for nsIWebContentConverterService.
unsafe impl XpCom for nsIWebContentConverterService {
    const IID: nsIID = nsID(0xde7cc06e, 0xe778, 0x45cb,
        [0xb7, 0xdb, 0x7a, 0x11, 0x4e, 0x1e, 0x75, 0xb1]);
}

// We need to implement the RefCounted trait so we can be used with `RefPtr`.
// This trait teaches `RefPtr` how to manage our memory.
unsafe impl RefCounted for nsIWebContentConverterService {
    #[inline]
    unsafe fn addref(&self) {
        self.AddRef();
    }
    #[inline]
    unsafe fn release(&self) {
        self.Release();
    }
}

// This trait is implemented on all types which can be coerced to from nsIWebContentConverterService.
// It is used in the implementation of `fn coerce<T>`. We hide it from the
// documentation, because it clutters it up a lot.
#[doc(hidden)]
pub trait nsIWebContentConverterServiceCoerce {
    /// Cheaply cast a value of this type from a `nsIWebContentConverterService`.
    fn coerce_from(v: &nsIWebContentConverterService) -> &Self;
}

// The trivial implementation: We can obviously coerce ourselves to ourselves.
impl nsIWebContentConverterServiceCoerce for nsIWebContentConverterService {
    #[inline]
    fn coerce_from(v: &nsIWebContentConverterService) -> &Self {
        v
    }
}

impl nsIWebContentConverterService {
    /// Cast this `nsIWebContentConverterService` to one of its base interfaces.
    #[inline]
    pub fn coerce<T: nsIWebContentConverterServiceCoerce>(&self) -> &T {
        T::coerce_from(self)
    }
}

// Every interface struct type implements `Deref` to its base interface. This
// causes methods on the base interfaces to be directly avaliable on the
// object. For example, you can call `.AddRef` or `.QueryInterface` directly
// on any interface which inherits from `nsISupports`.
impl ::std::ops::Deref for nsIWebContentConverterService {
    type Target = nsIWebContentHandlerRegistrar;
    #[inline]
    fn deref(&self) -> &nsIWebContentHandlerRegistrar {
        unsafe {
            ::std::mem::transmute(self)
        }
    }
}

// Ensure we can use .coerce() to cast to our base types as well. Any type which
// our base interface can coerce from should be coercable from us as well.
impl<T: nsIWebContentHandlerRegistrarCoerce> nsIWebContentConverterServiceCoerce for T {
    #[inline]
    fn coerce_from(v: &nsIWebContentConverterService) -> &Self {
        T::coerce_from(v)
    }
}

// This struct represents the interface's VTable. A pointer to a statically
// allocated version of this struct is at the beginning of every nsIWebContentConverterService
// object. It contains one pointer field for each method in the interface. In
// the case where we can't generate a binding for a method, we include a void
// pointer.
#[doc(hidden)]
#[repr(C)]
pub struct nsIWebContentConverterServiceVTable {
    /// We need to include the members from the base interface's vtable at the start
    /// of the VTable definition.
    pub __base: nsIWebContentHandlerRegistrarVTable,

    /* void setAutoHandler (in AString contentType, in nsIWebContentHandlerInfo handler); */
    pub SetAutoHandler: unsafe extern "system" fn (this: *const nsIWebContentConverterService, contentType: &::nsstring::nsAString, handler: *const nsIWebContentHandlerInfo) -> nsresult,

    /* nsIWebContentHandlerInfo getAutoHandler (in AString contentType); */
    pub GetAutoHandler: unsafe extern "system" fn (this: *const nsIWebContentConverterService, contentType: &::nsstring::nsAString, _retval: *mut *const nsIWebContentHandlerInfo) -> nsresult,

    /* nsIWebContentHandlerInfo getWebContentHandlerByURI (in AString contentType, in AString uri); */
    pub GetWebContentHandlerByURI: unsafe extern "system" fn (this: *const nsIWebContentConverterService, contentType: &::nsstring::nsAString, uri: &::nsstring::nsAString, _retval: *mut *const nsIWebContentHandlerInfo) -> nsresult,

    /* void loadPreferredHandler (in nsIRequest request); */
    pub LoadPreferredHandler: unsafe extern "system" fn (this: *const nsIWebContentConverterService, request: *const nsIRequest) -> nsresult,

    /* void removeProtocolHandler (in AString protocol, in AString uri); */
    pub RemoveProtocolHandler: unsafe extern "system" fn (this: *const nsIWebContentConverterService, protocol: &::nsstring::nsAString, uri: &::nsstring::nsAString) -> nsresult,

    /* void removeContentHandler (in AString contentType, in AString uri); */
    pub RemoveContentHandler: unsafe extern "system" fn (this: *const nsIWebContentConverterService, contentType: &::nsstring::nsAString, uri: &::nsstring::nsAString) -> nsresult,

    /* void getContentHandlers (in AString contentType, [optional] out unsigned long count, [array, size_is (count), retval] out nsIWebContentHandlerInfo handlers); */
    pub GetContentHandlers: unsafe extern "system" fn (this: *const nsIWebContentConverterService, contentType: &::nsstring::nsAString, count: *mut libc::uint32_t, handlers: *mut *mut *const nsIWebContentHandlerInfo) -> nsresult,

    /* void resetHandlersForType (in AString contentType); */
    pub ResetHandlersForType: unsafe extern "system" fn (this: *const nsIWebContentConverterService, contentType: &::nsstring::nsAString) -> nsresult,
}


// The implementations of the function wrappers which are exposed to rust code.
// Call these methods rather than manually calling through the VTable struct.
impl nsIWebContentConverterService {

    /// ```text
    /// /**
    ///    * Specifies the handler to be used to automatically handle all links of a
    ///    * certain content type from now on.
    ///    * @param   contentType
    ///    *          The content type to automatically load with the specified handler
    ///    * @param   handler
    ///    *          A web service handler. If this is null, no automatic action is
    ///    *          performed and the user must choose.
    ///    * @throws  NS_ERROR_NOT_AVAILABLE if the service refered to by |handler| is
    ///    *          not already registered.
    ///    */
    /// ```
    ///

    /// `void setAutoHandler (in AString contentType, in nsIWebContentHandlerInfo handler);`
    #[inline]
    pub unsafe fn SetAutoHandler(&self, contentType: &::nsstring::nsAString, handler: *const nsIWebContentHandlerInfo) -> nsresult {
        ((*self.vtable).SetAutoHandler)(self, contentType, handler)
    }


    /// ```text
    /// /**
    ///    * Gets the auto handler specified for a particular content type
    ///    * @param   contentType
    ///    *          The content type to look up an auto handler for.
    ///    * @returns The web service handler that will automatically handle all
    ///    *          documents of the specified type. null if there is no automatic
    ///    *          handler. (Handlers may be registered, just none of them specified
        ///    *          as "automatic").
    ///    */
    /// ```
    ///

    /// `nsIWebContentHandlerInfo getAutoHandler (in AString contentType);`
    #[inline]
    pub unsafe fn GetAutoHandler(&self, contentType: &::nsstring::nsAString, _retval: *mut *const nsIWebContentHandlerInfo) -> nsresult {
        ((*self.vtable).GetAutoHandler)(self, contentType, _retval)
    }


    /// ```text
    /// /**
    ///    * Gets a web handler for the specified service URI
    ///    * @param   contentType
    ///    *          The content type of the service being located
    ///    * @param   uri
    ///    *          The service URI of the handler to locate.
    ///    * @returns A web service handler that uses the specified uri.
    ///    */
    /// ```
    ///

    /// `nsIWebContentHandlerInfo getWebContentHandlerByURI (in AString contentType, in AString uri);`
    #[inline]
    pub unsafe fn GetWebContentHandlerByURI(&self, contentType: &::nsstring::nsAString, uri: &::nsstring::nsAString, _retval: *mut *const nsIWebContentHandlerInfo) -> nsresult {
        ((*self.vtable).GetWebContentHandlerByURI)(self, contentType, uri, _retval)
    }


    /// ```text
    /// /**
    ///    * Loads the preferred handler when content of a registered type is about
    ///    * to be loaded.
    ///    * @param   request
    ///    *          The nsIRequest for the load of the content
    ///    */
    /// ```
    ///

    /// `void loadPreferredHandler (in nsIRequest request);`
    #[inline]
    pub unsafe fn LoadPreferredHandler(&self, request: *const nsIRequest) -> nsresult {
        ((*self.vtable).LoadPreferredHandler)(self, request)
    }


    /// ```text
    /// /**
    ///    * Removes a registered protocol handler
    ///    * @param   protocol
    ///    *          The protocol scheme to remove a service handler for
    ///    * @param   uri
    ///    *          The uri of the service handler to remove
    ///    */
    /// ```
    ///

    /// `void removeProtocolHandler (in AString protocol, in AString uri);`
    #[inline]
    pub unsafe fn RemoveProtocolHandler(&self, protocol: &::nsstring::nsAString, uri: &::nsstring::nsAString) -> nsresult {
        ((*self.vtable).RemoveProtocolHandler)(self, protocol, uri)
    }


    /// ```text
    /// /**
    ///    * Removes a registered content handler
    ///    * @param   contentType
    ///    *          The content type to remove a service handler for
    ///    * @param   uri
    ///    *          The uri of the service handler to remove
    ///    */
    /// ```
    ///

    /// `void removeContentHandler (in AString contentType, in AString uri);`
    #[inline]
    pub unsafe fn RemoveContentHandler(&self, contentType: &::nsstring::nsAString, uri: &::nsstring::nsAString) -> nsresult {
        ((*self.vtable).RemoveContentHandler)(self, contentType, uri)
    }


    /// ```text
    /// /**
    ///    * Gets the list of content handlers for a particular type.
    ///    * @param   contentType
    ///    *          The content type to get handlers for
    ///    * @returns An array of nsIWebContentHandlerInfo objects
    ///    */
    /// ```
    ///

    /// `void getContentHandlers (in AString contentType, [optional] out unsigned long count, [array, size_is (count), retval] out nsIWebContentHandlerInfo handlers);`
    #[inline]
    pub unsafe fn GetContentHandlers(&self, contentType: &::nsstring::nsAString, count: *mut libc::uint32_t, handlers: *mut *mut *const nsIWebContentHandlerInfo) -> nsresult {
        ((*self.vtable).GetContentHandlers)(self, contentType, count, handlers)
    }


    /// ```text
    /// /**
    ///    * Resets the list of available content handlers to the default set from
    ///    * the distribution.
    ///    * @param   contentType
    ///    *          The content type to reset handlers for
    ///    */
    /// ```
    ///

    /// `void resetHandlersForType (in AString contentType);`
    #[inline]
    pub unsafe fn ResetHandlersForType(&self, contentType: &::nsstring::nsAString) -> nsresult {
        ((*self.vtable).ResetHandlersForType)(self, contentType)
    }


}