System.IInterface.QueryInterface
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).