CCmdQueue::New

The New method initializes a command to be run and returns a new CDeferredCommand object.

Syntax

virtual HRESULT New(
    CDeferredCommand **ppCmd,
    LPUNKNOWN pUnk,
    REFTIME time,
    GUID *iid,
    long dispidMethod,
    short wFlags,
    long cArgs,
    VARIANT *pDispParams,
    VARIANT *pvarResult,
    short *puArgErr,
    BOOL bStream
);

Parameters

ppCmd

Address of a pointer to a CDeferredCommand object by which an application can cancel the command, set a new presentation time for it, or retrieve estimate information.

pUnk

Pointer to the object that will run the command.

time

Time at which to run the queued command or commands.

iid

Pointer to the globally unique identifier (GUID) of the interface to call.

dispidMethod

Method on the interface to be called.

wFlags

Flags describing the context of the call. This parameter supports the same flags as the IDispatch::Invoke method.

cArgs

Number of arguments passed.

pDispParams

Pointer to the list of variant types associated with the dispatch parameters.

pvarResult

Pointer to the list where results, if any, are to be returned.

puArgErr

Pointer to the index within the pDispParams parameter list where the last error occurred.

bStream

Value indicating whether the time parameter is a stream-time value (TRUE) or a presentation-time value (FALSE).

Return Value

Returns S_OK if successful. Returns E_OUTOFMEMORY if ppCmd returns from creating the new CDeferredCommand object with a value of NULL. Otherwise, returns an HRESULT that indicates an error from attempting to create a new CDeferredCommand object. If there is an error, no object has been queued.

Remarks

The new CDeferredCommand object will be initialized with the parameters and will be added to the queue during construction. This method is similar to the IDispatch::Invoke method.

Values for the wFlags parameter include the following:

See Also

• CCmdQueue Class