nsIInterfaceRequestor

IID:033A1470-8B2A-11d3-AF88-00A024FFC08C
Inherits From:nsISupports
Status:FROZEN

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.

This interface is implemented by the following components:


Methods

void getInterface ( nsIIDRef uuid , out nsQIResult* result )

void getInterface ( nsIIDRef uuid , out nsQIResult* result )

Retrieves the specified interface pointer.

Arguments:
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.

References

This interface is the type of the following properties:

nsIChannel.notificationCallbacks, nsILoadGroup.notificationCallbacks, nsISSLSocketControl.notificationCallbacks, nsISmtpUrl.notificationCallbacks, nsISocketTransport.securityCallbacks

This interface is passed as an argument to the following methods:

nsIBadCertListener.confirmCertExpired, nsIBadCertListener.confirmMismatchDomain, nsIBadCertListener.confirmUnknownIssuer, nsIBadCertListener.notifyCrlNextupdate, nsICertPickDialogs.PickCertificate, nsICertificateDialogs.confirmDownloadCACert, nsICertificateDialogs.crlImportStatusDialog, nsICertificateDialogs.getPKCS12FilePassword, nsICertificateDialogs.notifyCACertExists, nsICertificateDialogs.setPKCS12FilePassword, nsICertificateDialogs.viewCert, nsIClientAuthDialogs.ChooseCertificate, nsIContentHandler.handleContent, nsIExternalHelperAppService.doContent, nsIFormSigningDialog.confirmSignText, nsIGeneratingKeypairInfoDialogs.displayGeneratingKeypairInfo, nsISecurityWarningDialogs.confirmEnteringSecure, nsISecurityWarningDialogs.confirmEnteringWeak, nsISecurityWarningDialogs.confirmLeavingSecure, nsISecurityWarningDialogs.confirmMixedMode, nsISecurityWarningDialogs.confirmPostToInsecure, nsISecurityWarningDialogs.confirmPostToInsecureFromSecure, nsISmtpService.SendMailMessage, nsITokenDialogs.ChooseToken, nsITokenPasswordDialogs.getPassword, nsITokenPasswordDialogs.setPassword, nsIURILoader.openURI, nsIUserCertPicker.pickByUsage, nsIX509CertDB.importCertificates, nsIX509CertDB.importEmailCertificate, nsIX509CertDB.importServerCertificate, nsIX509CertDB.importUserCertificate

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com