IADsExtension::PrivateInvoke method (iads.h)

Article
10/13/2021

The IADsExtension::PrivateInvoke method is normally called by ADSI after the IADsExtension::PrivateGetIDsOfNames method. This method can either have a custom implementation or it can delegate the operation to IDispatch::DispInvoke method.

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
);

Parameters

[in] dispidMember

Identifies the member. Use the IADsExtension::PrivateGetIDsOfNames method to obtain the dispatch identifier.

[in] riid

Reserved for future use. Must be IID_NULL.

[in] lcid

The locale context in which to interpret arguments. The IADsExtension::PrivateGetIDsOfNames function uses lcid. It is also passed to the PrivateInvoke method to allow the object to interpret the arguments that are specific to a locale.

[in] wFlags

Flags that describe the context of the PrivateInvoke call, include.

DISPATCH_METHOD

The member is invoked as a method. If a property has the same name, both this and the DISPATCH_PROPERTYGET flag may be set.

DISPATCH_PROPERTYGET

The member is retrieved as a property or data member.

DISPATCH_PROPERTYPUT

The member is changed as a property or data member.

DISPATCH_PROPERTYPUTREF

The member is changed by a reference assignment, rather than a value assignment. This flag is valid only when the property accepts a reference to an object.

[in] pdispparams

Pointer to a DISPPARAMS structure that receives an array of arguments, an array of argument DISPIDs for named arguments, and counts for the number of elements in the arrays.

[out] pvarResult

Pointer to the location where the result is to be stored, or NULL if the caller expects no result. This argument is ignored if DISPATCH_PROPERTYPUT or DISPATCH_PROPERTYPUTREF is specified.

[out] pexcepinfo

Pointer to a structure that contains exception data. This structure should be filled in if DISP_E_EXCEPTION is returned. Can be NULL.

[out] puArgErr

The index within the rgvarg member of the DISPPARAMS structure in pdispparams for the first argument that has an error. Arguments are stored in the rgvarg array in reverse order, so the first argument is the one with the highest index in the array. This parameter is returned only when the resulting return value is DISP_E_TYPEMISMATCH or DISP_E_PARAMNOTFOUND.

Return value

This method supports the standard return values, as well as the following.

For more information about other return values, see ADSI Error Codes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll