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.