IADsExtension::P rivateInvoke-Methode (iads.h)

2024-02-28

Die IADsExtension::P rivateInvoke-Methode wird normalerweise von ADSI nach der IADsExtension::P rivateGetIDsOfNames-Methode aufgerufen. Diese Methode kann entweder über eine benutzerdefinierte Implementierung verfügen oder den Vorgang an die IDispatch::D ispInvoke-Methode delegieren.

Syntax

HRESULT PrivateInvoke(
  [in]  DISPID       dispidMember,
  [in]  REFIID       riid,
  [in]  LCID         lcid,
  [in]  WORD         wFlags,
  [in]  DISPPARAMS   *pdispparams,
  [out] VARIANT      *pvarResult,
  [out] EXCEPINFO    *pexcepinfo,
  [out] unsigned int *puArgErr
);

Parameter

[in] dispidMember

Bezeichnet den Member. Verwenden Sie die IADsExtension::P rivateGetIDsOfNames-Methode , um den Dispatchbezeichner abzurufen.

[in] riid

Für zukünftige Verwendung reserviert. Muss IID_NULL sein.

[in] lcid

Der Gebietsschemakontext, in dem Argumente interpretiert werden sollen. Die Funktion IADsExtension::P rivateGetIDsOfNames verwendet lcid. Es wird auch an die PrivateInvoke-Methode übergeben, damit das Objekt die Argumente interpretieren kann, die für ein Gebietsschema spezifisch sind.

[in] wFlags

Flags, die den Kontext des PrivateInvoke-Aufrufs beschreiben, schließen ein.

DISPATCH_METHOD

Der Member wird als Methode aufgerufen. Wenn eine Eigenschaft denselben Namen hat, können sowohl dieses als auch das DISPATCH_PROPERTYGET-Flag 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.

[in] pdispparams

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 empfängt.

[out] pvarResult

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 wird.

[out] pexcepinfo

Zeiger auf eine Struktur, die Ausnahmedaten enthält. Diese Struktur sollte ausgefüllt werden, wenn DISP_E_EXCEPTION zurückgegeben wird. Kann NULL sein.

[out] puArgErr

Der Index innerhalb des rgvarg-Elements der DISPPARAMS-Struktur in pdispparams für das erste Argument, das einen Fehler aufweist. Argumente werden im rgvarg-Array in umgekehrter Reihenfolge 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.

Rückgabewert

Diese Methode unterstützt die standardmäßigen Rückgabewerte sowie folgendes.

Weitere Informationen zu anderen Rückgabewerten finden Sie unter ADSI-Fehlercodes.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll