CComSafeArray::Add
Aggiunge uno o più elementi, o una struttura SAFEARRAY, a CComSafeArray.
HRESULT Add(
const SAFEARRAY * psaSrc
);
HRESULT Add(
ULONG ulCount,
const T * pT,
BOOL bCopy = TRUE
);
HRESULT Add(
const T& t,
BOOL bCopy = TRUE
);
Parametri
psaSrc
Un puntatore a un oggetto SAFEARRAY.ulCount
Il numero di oggetti da aggiungere alla matrice.pint
Un puntatore a uno o più oggetti alla matrice.t
Un riferimento all'oggetto da aggiungere alla matrice.bCopy
Indica se una copia dei dati deve essere creata.Il valore predefinito è TRUE.
Valore restituito
Restituisce S_OK su positivo, o un errore HRESULT di errore.
Note
I nuovi oggetti vengono aggiunti alla fine dell'oggetto esistente SAFEARRAY.L'aggiunta di un oggetto a un oggetto multidimensionale SAFEARRAY non è supportata.Nell'aggiungere una matrice esistente di oggetti, entrambe le matrici devono contenere elementi dello stesso tipo.
Il flag bCopy viene considerato quando gli elementi di tipo BSTR o VARIANT aggiunte a una matrice.Il valore predefinito TRUE assicura che una nuova copia venga effettuata dei dati quando l'elemento viene aggiunto alla matrice.
Requisiti
Header: atlsafe.h