You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.


TOC PREV NEXT INDEX

Embedding Gecko API


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.

Written by:Ellen Evans | Comments, questions, complaints? Bug 143387
TOC PREV NEXT INDEX