Freigeben über


COM_INTERFACE_ENTRY_FUNC

Ein allgemeiner Mechanismus zum Verbinden in QueryInterface ATL der Logik.

COM_INTERFACE_ENTRY_FUNC( iid, dw, func )

Parameter

  • iid
    [in] Die GUID der Schnittstelle verfügbar gemacht.

  • dw
    [in] Ein Parameter übergeben zu func.

  • func
    [in] Der Funktionszeiger, der iid zurückgibt.

Hinweise

Wenn iid die IID der Schnittstelle übereinstimmt, die für abgefragt wird, wird die Funktion, die durch func angegeben wird, aufgerufen.Die Deklaration für die Funktion sollte sein:

HRESULT WINAPI func(void* pv, REFIID riid, LPVOID* ppv, DWORD_PTR dw);

Wenn die Funktion aufgerufen wird, zeigt pv auf das Klassenobjekt.Der riid-Parameter verweist auf die Schnittstelle, die für abgefragt wird, ist ppv der Zeiger auf den Speicherort, an dem die Funktion den Zeiger auf die Schnittstelle speichern soll, und dw ist der Parameter, den Sie im Eintrag angegeben haben.Die Funktion sollte *ppv auf NULL festlegen und E_NOINTERFACE oder S_FALSE zurückgeben, wenn sie beschließt, keine Schnittstelle zurückzugeben.Mit E_NOINTERFACE beendet wird COM-Zuordnungsverarbeitung.Mit S_FALSE wird COM-Zuordnungsverarbeitung fort, obwohl kein Schnittstellenzeiger zurückgegeben wurde.Wenn die Funktion einen Schnittstellenzeiger zurückgibt, sollte sie S_OK zurückgeben.

Siehe COM_INTERFACE_ENTRY-Makros für Hinweise zu COM-Zuordnungs-Einträge.

Anforderungen

Header: möchten

Siehe auch

Weitere Ressourcen

COM-Zuordnungs-Makros

ATL-Makros