Поделиться через


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
    Число объектов, добавляемых в массив.

  • пт
    Указатель на один или несколько объектов, добавляемых в массив.

  • t
    Ссылка на объект, добавляемый в массив.

  • bCopy
    Указывает, должна ли копия данных создана. Значение по умолчанию TRUE.

Возвращаемое значение

Возвращает значение S_ОК на успешное завершение или ошибка HRESULT в случае сбоя.

Заметки

Добавитьы новые объекты в конец существующего объекта SAFEARRAY. Не поддерживается добавления объекта к многомерному объект SAFEARRAY. При добавлении существующий массив объектов, оба массива должны содержать элементы одного и того же типа.

Пометить bCopy считается если элементы типа BSTR или VARIANT добавлены в массив. Значение по умолчанию TRUE гарантирует, что новая копия становится данных, когда элемент добавить в массив.

Требования

Header: atlsafe.h

См. также

Ссылки

CComSafeArray Class