CComSafeArray::Add
Ajoute un ou plusieurs éléments, ou une structure de 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
);
Paramètres
psaSrc
Un pointeur vers un objet de SAFEARRAY .ulCount
Le nombre d'objets à ajouter au tableau.pinte
Un pointeur vers un ou plusieurs objets à ajouter au tableau.t
Une référence à l'objet à ajouter au tableau.bCopy
Indique si une copie des données doit être créée.La valeur par défaut est TRUE.
Valeur de retour
Retourne S_OK en cas de réussite, ou une erreur HRESULT en cas de échec.
Notes
Les nouveaux objets sont ajoutés à la fin de l'objet existant de SAFEARRAY .Ajouter un objet à un objet multidimensionnel de SAFEARRAY n'est pas pris en charge.En ajoutant un tableau existant d'objets, les deux tableaux doivent contenir des éléments du même type.
La balise d' bCopy est prise en compte lorsque les éléments du type BSTR ou variant sont ajoutés à un tableau.La valeur par défaut de TRUE garantit qu'une nouvelle copie est effectuée des données lorsque l'élément est ajouté au tableau.
Configuration requise
Header: atlsafe.h