Soap.SOAPHTTPClient.THTTPRIO.QueryInterface

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function QueryInterface(const IID: TGUID; out Obj): HResult; override; stdcall;

C++

HRESULT __stdcall QueryInterface(::System::DelphiInterface<T>& smartIntf)
virtual HRESULT __stdcall QueryInterface(const GUID &IID, /* out */ void *Obj);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Soap.SOAPHTTPClient.pas
Soap.SOAPHTTPClient.hpp
Soap.SOAPHTTPClient THTTPRIO

Beschreibung

Implementiert die IInterface-Schnittstellenmethode QueryInterface.

QueryInterface wird durch die IInterface-Schnittstelle aufgerufen, um einen Zeiger für die im Parameter IID angegebene Schnittstelle abzurufen. Der Aufruf erfolgt in Delphi, wenn eine Anwendung THTTPRIO mit dem Operator as in eine aufrufbare Schnittstelle umwandelt.

THTTPRIO kann nur einen Schnittstellenzeiger eines bestimmten Typs zurückgeben. Wenn QueryInterface in einer Anwendung zum ersten Mal aufgerufen wird, erzeugt THTTPRIO eine Methodentabelle im Speicher, um für die angeforderte Schnittstelle Methodenaufrufe zu ermöglichen.

IID bezeichnet die aufrufbare Schnittstelle, die mit Hilfe der THTTPRIO-Instanz aufgerufen werden soll. Wenn das THTTPRIO-Objekt bereits in eine Schnittstelle umgewandelt wurde, muss diese im Parameter IID angegeben werden. Andernfalls muss IID eine registrierte aufrufbare Schnittstelle enthalten.

Obj gibt einen Schnittstellenzeiger für die angegebene Schnittstelle zurück (Voraussetzung dafür ist, dass THTTPRIO noch keine andere Schnittstelle implementiert hat und der Parameter IID eine registrierte Schnittstelle bezeichnet).

QueryInterface gibt den Wert 0 zurück (S_OK), wenn in Obj ein Schnittstellenzeiger bereitgestellt werden konnte. Andernfalls wird E_NOINTERFACE zurückgegeben.

Anmerkung:  In der zweiten C++ Syntax (mit Template) wird ein DelphiInterface-Wrapper für den gewünschten Schnittstellentyp übergeben.

Wenn QueryInterface einen Schnittstellenzeiger zurückgibt, wird automatisch der Referenzzähler erhöht.

Siehe auch