System.IInterface.QueryInterface

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public System.pas System IInterface

Beschreibung

Gibt eine Referenz auf ein bestimmtes Interface zurück, wenn das Objekt dieses Interface unterstützt.

QueryInterface überprüft, ob das Objekt, das das IInterface-Interface implementiert, das in IID angegbene Interface unterstützt. Ist dies der Fall, werden folgende Operationen von QueryInterface durchgeführt:

  • Der Referenzzähler wird erhöht.
  • Der Parameter Obj wird so gesetzt, dass er auf eine Instanz des angegebenen Interface zeigt.
  • S_OK (0) wird zurückgegeben, um den Erfolg anzugeben.

Unterstützt das Objekt das Interface nicht, gibt QueryInterface einen Fehlercode ungleich 0 zurück (z.B. E_NoInterface).

Siehe auch