CComSafeArray::Add

添加一个或多个元素或一 SAFEARRAY 结构,以便 CComSafeArray

HRESULT Add(
   const SAFEARRAY * psaSrc 
);
HRESULT Add(
   ULONG ulCount,
   const T * pT,
   BOOL bCopy = TRUE
);
HRESULT Add(
   const T& t,
   BOOL bCopy = TRUE
);

参数

  • psaSrc
    SAFEARRAY 对象的指针。

  • ulCount
    添加的对象数。数组。

  • pT
    对要添加的一个或多个对象的指针到数组。

  • t
    对要添加的对象的引用数组。

  • bCopy
    指示是否应创建数据的副本。 默认值为 TRUE

返回值

返回在成功的S_OK或在失败时错误HRESULT。

备注

新的对象被追加到现有 SAFEARRAY 对象的末尾。 添加到多维 SAFEARRAY 对象的对象不受支持。 在添加现有对象数组时,两个数组必须包含相同类型的元素。

它的类型 BSTRVARIANT 的元素添加到数组时,bCopy 标志会考虑。 TRUE 的默认确保新副本数据,则该组件添加到数组时。

要求

Header: atlsafe.h

请参见

参考

CComSafeArray选件类