nsIWeakReference

xpcom/base/nsIWeakReference.idlScriptable

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