COM_INTERFACE_ENTRY_FUNC ( Iid, dw, Func )
Parameter
iid
[in] Die GUID für die Schnittstelle verfügbar gemacht werden.
dw
[in] An den Func übergeben ein parameter.
func
[in] Der Funktionszeiger, der Iid zurückgibt.
Bemerkungen
Ein allgemeiner Mechanismus zum Einhängen in die ATL QueryInterface Logik. Wenn Iid entspricht die IID der Schnittstelle abgefragt wird, dann die Funktion von Func angegeben. Die Deklaration für die Funktion sollte sein:
HRESULT WINAPI Func (Void * pv, REFIID Riid, LPVOID * Ppv, DWORD dw)
Wenn die Funktion aufgerufen, pv verweist auf Ihr Class-Objekt. Der Riid -Parameter verweist auf die abgefragten für Schnittstelle, Ppv ist der Zeiger auf den Speicherort, wo die Funktion speichern sollte den Zeiger auf die Schnittstelle, und dw ist der Parameter, den Sie im Eintrag angegeben. Die Funktion sollte gesetzt *Ppv auf NULL , und Rückkehr E_NOINTERFACE oder S_FALSE entscheidet es sich nicht um eine Schnittstelle zurückzugeben. Mit E_NOINTERFACEbeendet die COM Karte Verarbeitung. Mit S_FALSEweiter COM Karte Verarbeitung, obwohl keine Schnittstellenzeiger zurückgegeben wurde. Wenn die Funktion gibt einen Schnittstellenzeiger zurück, sollte es S_OK zurück.
Finden Sie unter COM_INTERFACE_ENTRY Makros für Bemerkungen über COM-Zuordnungseinträgen.