Mozilla.org

nsIInterfaceRequestor

---

This interface defines a generic interface for requesting interfaces to which a given object might provide access. It is very similar to QueryInterface found in nsISupports . The main difference is that interfaces returned from GetInterface are not required to provide a way back to the object implementing this interface. The semantics of QI dictate that given an interface A that you QI on to get to interface B, you must be able to QI on B to get back to A. This interface, however, allows you to obtain an interface C from A that may or most likely will not have the ability to get back to A. This interface is scriptable.

Methods

getInterface

Retrieves the specified interface pointer.

Syntax:

void nsIInterfaceRequestor::getInterface(
	in nsIIDRef uuid,
	[iid_is(uuid),retval]out nsQIResult result) 

Parameters:

uuid: The IID of the interface being requested.

result: [out] The interface pointer to be filled in if the interface is accessible.

nsresult:

NS_OK if the interface was successfully returned.

NS_NOINTERFACE if the interface is not accessible.

NS_ERROR* if there is method failure.