IExpDispSupport::OnInvoke-Methode (shdeprecated.h)

Veraltet. Ruft Ambient-Eigenschaften ab.

Syntax

HRESULT OnInvoke(
  [in] DISPID     dispidMember,
  [in] REFIID     iid,
  [in] LCID       lcid,
  [in] WORD       wFlags,
       DISPPARAMS *pdispparams,
       VARIANT    *pVarResult,
       EXCEPINFO  *pexcepinfo,
       UINT       *puArgErr
);

Parameter

[in] dispidMember

Typ: DISPID

Eine Verteiler-ID, die den aufgerufenen Member identifiziert.

[in] iid

Typ: REFIID

Reserviert. Muss IID_NULL sein.

[in] lcid

Typ: LCID

Eine Gebietsschema-ID, die einen Gebietsschemakontext bereitstellt, in dem Argumente interpretiert werden sollen. Anwendungen, die mehrere Sprachen nicht unterstützen, können diesen Parameter ignorieren.

[in] wFlags

Typ: WORD

Flags, die den Kontext des Aufrufs beschreiben, einschließlich der folgenden.

DISPATCH_METHOD

Der Member wird als Methode aufgerufen. Wenn eine Eigenschaft denselben Namen hat, können sowohl dieser als auch das flag DISPATCH_PROPERTYGET festgelegt werden. Der Member wird als Methode aufgerufen. Wenn eine Eigenschaft denselben Namen hat, können sowohl dieser als auch das flag DISPATCH_PROPERTYGET festgelegt werden.

DISPATCH_PROPERTYGET

Der Member wird als Eigenschaft oder Datenmember abgerufen.

DISPATCH_PROPERTYPUT

Das Element wird als Eigenschaft oder Datenmember geändert.

DISPATCH_PROPERTYPUTREF

Das Element wird durch eine Verweiszuweisung und nicht durch eine Wertzuweisung geändert. Dieses Flag ist nur gültig, wenn die -Eigenschaft einen Verweis auf ein -Objekt akzeptiert.

pdispparams

Typ: DISPPARAMS*

Ein Zeiger auf eine DISPPARAMS-Struktur , die ein Array von Argumenten, ein Array von Argument-DISPIDs für benannte Argumente und die Anzahl der Elemente in den Arrays enthält.

pVarResult

Typ: VARIANT*

Ein Zeiger auf den Speicherort, an dem das Ergebnis gespeichert werden soll, oder NULL , wenn der Aufrufer kein Ergebnis erwartet. Dieses Argument wird ignoriert, wenn DISPATCH_PROPERTYPUT oder DISPATCH_PROPERTYPUTREF angegeben ist.

pexcepinfo

Typ: EXCEPINFO*

Ein Zeiger auf eine Struktur mit Ausnahmeinformationen. Diese Struktur sollte ausgefüllt werden, wenn DISP_E_EXCEPTION zurückgegeben wird. Kann NULL sein.

puArgErr

Typ: UINT*

Der Index innerhalb des rgvarg-Elements der DISPPARAMS-Struktur des ersten Arguments, das einen Fehler aufweist. Argumente werden in umgekehrter Reihenfolge in rgvarg gespeichert, sodass das erste Argument das Argument mit dem höchsten Index im Array ist. Dieser Parameter wird nur zurückgegeben, wenn der resultierende Rückgabewert DISP_E_TYPEMISMATCH oder DISP_E_PARAMNOTFOUND ist. Dieses Argument kann auf NULL festgelegt werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Weitere Informationen finden Sie unter IDispatch::Invoke.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	shdeprecated.h