mozilla
Your Search Results

    nsIWeakReference

    This interface represents a proxy for an XPCOM object. It allows a consumer to hold an indirect, non-owning reference to an XPCOM object.
    Inherits from: nsISupports Last changed in Gecko 0.9.9

    An instance of nsIWeakReference is a proxy object that cooperates with its referent to give clients a non-owning, non-dangling reference. Clients own the nsIWeakReference instance.

    Method overview

    void QueryReferent( in nsIIDRef uuid, [iid_is(uuid), retval] out nsQIResult result );

    Methods

    QueryReferent()

    This method queries an interface on the referent if it exists, and like nsISupports.QueryInterface(), produces an owning reference to the desired interface.")}} It is designed to look and act exactly like (a proxied) nsISupports.QueryInterface(). Do not hold on to the produced interface permanently; that would defeat the purpose of using a non-owning nsIWeakReference in the first place.

    void QueryReferent(
      in nsIIDRef uuid,
      [iid_is(uuid), retval] out nsQIResult result 
    );
    
    Parameters
    uuid
    The UUID of the requested interface.
    result
    The resulting interface pointer.
    Exceptions thrown
    NS_ERROR_NULL_POINTER
    The referent no longer exists.
    NS_ERROR_NO_INTERFACE
    The requested interface is not available.

    Remarks

    This interface was frozen for Gecko 0.9.9. See bug 48726 for details. From Gecko 2.0 interfaces are no longer frozen.

    See also

    Document Tags and Contributors

    Contributors to this page: Sheppy, Nickolay, trevorh, Andreas Wuest, Pmash, Biesi
    Last updated by: Sheppy,