CCmdQueue.New 方法

该方法 New 初始化要运行的命令,并返回新的 CDeferredCommand 对象。

语法

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

参数

ppCmd

指向 CDeferredCommand 对象的指针的地址,应用程序可以通过该对象取消命令、为其设置新的演示文稿时间或检索估计信息。

朋 克

指向将运行命令的对象的指针。

time

运行排队命令或命令的时间。

Iid

指向要调用的接口 (GUID) 全局唯一标识符的指针。

dispidMethod

要调用的接口上的方法。

wFlags

描述调用的上下文的标志。 此参数支持与 IDispatch::Invoke 方法相同的标志。

cArgs

传递的参数数。

pDispParams

指向与调度参数关联的变体类型的列表的指针。

pvarResult

指向要返回结果的列表(如果有)的指针。

puArgErr

指向 pDispParams 参数列表中发生最后一个错误的索引的指针。

bStream

指示时间参数是流 时间 值 (TRUE) 还是表示时间值 (FALSE) 的值。

返回值

如果成功,则返回S_OK。 如果 ppCmd 从创建值为 NULL 的新 CDeferredCommand 对象返回,则返回E_OUTOFMEMORY。 否则,返回 一个 HRESULT ,指示尝试创建新的 CDeferredCommand 对象时出错。 如果出现错误,则没有对对象进行排队。

注解

新的 CDeferredCommand 对象将使用参数进行初始化,并在构造过程中添加到队列中。 此方法类似于 IDispatch::Invoke 方法。

wFlags 参数的值包括:

说明
DISPATCH_METHOD 成员作为方法运行。 如果属性具有相同的名称,则可以设置此标志和DISPATCH_PROPERTYGET标志。
DISPATCH_PROPERTYGET 该成员作为属性或数据成员进行检索。
DISPATCH_PROPERTYPUT 成员正在更改为属性或数据成员。
DISPATCH_PROPERTYPUTREF 成员正通过引用赋值而不是值赋值进行更改。 仅当属性接受对对象的引用时,此值才有效。

要求

要求 Value
标头
Winutil.h (包括 Streams.h)

Strmbase.lib (零售版) ;
Strmbasd.lib (调试生成)

另请参阅

CCmdQueue 类