CComSafeArray::Add
Fügt eine oder mehrere Elemente oder eine SAFEARRAY-Struktur, CComSafeArray hinzu.
HRESULT Add(
const SAFEARRAY * psaSrc
);
HRESULT Add(
ULONG ulCount,
const T * pT,
BOOL bCopy = TRUE
);
HRESULT Add(
const T& t,
BOOL bCopy = TRUE
);
Parameter
psaSrc
Ein Zeiger auf ein Objekt SAFEARRAY.ulCount
Die Anzahl der dem Array hinzuzufügen, Objekten.Pint
Ein Zeiger auf ein oder mehrere - Array hinzugefügt werden, Objekten.t
Ein Verweis auf das Array hinzugefügt werden, Objekt.bCopy
Gibt an, ob eine Kopie der Daten erstellt werden soll.Der Standardwert ist TRUE.
Rückgabewert
EINGABETASTE S_OK bei Erfolg oder Fehler HRESULT auf Fehler.
Hinweise
Die neuen Objekte werden am Ende des vorhandenen Objekts SAFEARRAY angefügt.Das Hinzufügen eines Objekts zu einem mehrdimensionalen SAFEARRAY-Objekt wird nicht unterstützt.Wenn sie ein vorhandenes Objektarray hinzufügen, müssen beide Arrays Elementen des gleichen Typs enthalten.
Das Flag ist bCopy berücksichtigt, wenn Elemente des Typs BSTR oder VARIANT zu einem Array hinzugefügt werden.Der Standardwert von TRUE gewährleistet, dass eine neue Kopie der Daten erstellt wird, wenn das Element dem Array hinzugefügt wird.
Anforderungen
Header: atlsafe.h