Anzeigen: Delphi
C++
Anzeigeeinstellungen
System.IUnknown.QueryInterface
Aus XE2 API Documentation
Delphi
function QueryInterface(const IID: TGUID; out Obj): HResult; stdcall;
C++
virtual HRESULT STDMETHODCALLTYPE QueryInterface(/* [in] */ REFIID riid, /* [iid_is][out] */ __RPC__deref_out void __RPC_FAR *__RPC_FAR *ppvObject) = 0; QueryInterface(Q** pp)
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.pas unknwn.h |
System | IUnknown |
Beschreibung
Gibt eine Referenz auf eine angegebene Schnittstelle zurück, wenn das Objekt die betreffende Schnittstelle unterstützt.
QueryInterface überprüft, ob das Objekt, das diese Schnittstelle implementiert, auch die in IID angegebene Schnittstelle unterstützt. Wenn dies der Fall ist, führt QueryInterface die folgenden Aktionen durch:
- inkrementiert den Referenzzähler;
- setzt das Parameter Obj, um auf eine Instanz der angegebenen Schnittstelle zu zeigen;
- gibt 0 zurück, um den Erfolg anzuzeigen.
Unterstützt das Objekt die Schnittstelle nicht, gibt QueryInterface einen Fehlercode ungleich Null zurück, wie z.B. E_NoInterface.