COM Vuser Functions (LRC) > Alphabetical List of Functions > lrc_DispPropertyPut

lrc_DispPropertyPut

Example: lrc_DispPropertyPut IDispatch Interface Calls

Sets a property using the IDispatch interface.

void lrc_DispPropertyPut( IDispatch * pDispatch, char *idName, unsigned long locale, ...);
*pDispatch A pointer to the IDispatch interface.
*idName A pointer to the name of the property.
locale The language locale.

Additional Arguments

Args The value or values (in the case of an array) to set.
OPTIONAL_ARGS An optional flag signaling that the next arguments will be a series of pairs of specific array indices and values to set (the named arguments of the DispParams structure in the original Microsoft definition).
LAST_ARG A flag signaling that the preceding argument was the last argument.
__CheckResult This flag is generated by VuGen to indicate if the call was successful when the script was generated and HRESULT should be checked. Values: CHECK_HRES or DONT_CHECK_HRES.

lrc_DispPropertyPut sets a property using the IDispatch interface. The call sets the DISPATCH_PROPERTYPUT flag.

IDispatch is a "meta-interface" that exposes all of the other interfaces and methods of a COM object. Calls to IDispatch:Invoke from VuGen scripts are implemented using lrc_Disp functions. These calls are constructed somewhat differently from calls to other interfaces. Calls to GetIDsOfNames are hidden inside the lrc_Disp calls. Each lrc_Disp call sets a different wflags parameter value when it calls IDispatch:Invoke. The lrc_DispPropertyPut call sets the DISPATCH_PROPERTYPUT flag.

Return Values

lrc Return Values

Parameterization

You cannot use standard parameterization for any arguments in this function.