CComSafeArray::Add
Dodaje jeden lub więcej elementów lub SAFEARRAY struktury do CComSafeArray.
HRESULT Add(
const SAFEARRAY * psaSrc
);
HRESULT Add(
ULONG ulCount,
const T * pT,
BOOL bCopy = TRUE
);
HRESULT Add(
const T& t,
BOOL bCopy = TRUE
);
Parametry
psaSrc
Wskaźnik do SAFEARRAY obiektu.ulCount
Liczba obiektów, aby dodać do tablicy.pT
Wskaźnik do jednego lub kilku obiektów, które mają zostać dodane do tablicy.t
Odwołanie do obiektu, który ma zostać dodany do macierzy.bCopy
Wskazuje, czy należy utworzyć kopię danych.Wartością domyślną jest TRUE.
Wartość zwracana
Zwraca wartość S_OK na powodzenie lub błąd HRESULT awarii.
Uwagi
Nowe obiekty są dołączane na końcu istniejącej SAFEARRAY obiektu.Dodanie obiektu do wielowymiarowe SAFEARRAY obiektu nie jest obsługiwany.Podczas dodawania istniejącą tablicę obiektów, obydwie tablice mogą zawierać elementy tego samego typu.
bCopy Flaga jest brana pod uwagę podczas elementy typu BSTR lub WARIANTU są dodawane do tablicy.Wartość domyślna, TRUE zapewnia, że wykonywana jest kopia nowych danych, gdy element zostanie dodany do macierzy.
Wymagania
Nagłówek: atlsafe.h