Public Member Functions

nsIInterfaceRequestor Interface Reference

The nsIInterfaceRequestor interface defines a generic interface for requesting interfaces that a given object might provide access to. More...

import "nsIInterfaceRequestor.idl";

Inheritance diagram for nsIInterfaceRequestor:

List of all members.

Public Member Functions

void getInterface (in nsIIDRef uuid,[iid_is(uuid), retval] out nsQIResult result)
 Retrieves the specified interface pointer.

Detailed Description

The nsIInterfaceRequestor interface defines a generic interface for requesting interfaces that a given object might provide access to.

This 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.


Member Function Documentation

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

Retrieves the specified interface pointer.

Parameters:
uuid The IID of the interface being requested.
result [out] The interface pointer to be filled in if the interface is accessible.
Returns:
NS_OK - interface was successfully returned. NS_NOINTERFACE - interface not accessible. NS_ERROR* - method failure.

The documentation for this interface was generated from the following file: