CComSafeArray::Add
Adiciona um ou mais elementos, ou uma estrutura de 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
);
Parâmetros
psaSrc
Um ponteiro para um objeto de SAFEARRAY .ulCount
O número de objetos para adicionar à matriz.pinta
Um ponteiro para um ou mais objetos a serem adicionados à matriz.t
Uma referência ao objeto a ser adicionado à matriz.bCopy
Indica se uma cópia dos dados deve ser criada. o valor padrão é Verdadeiro.
Valor de retorno
Retorna S_OK em êxito, ou um erro HRESULT em caso de falha.
Comentários
Novos objetos são acrescentados ao final do objeto existente de SAFEARRAY . Adicionar um objeto para um objeto de SAFEARRAY multidimensional não é suportado. A o adicionar uma matriz existente de objetos, as duas matrizes devem conter elementos do mesmo tipo.
O sinalizador de bCopy em consideração quando é a maioria dos elementos de tipo BSTR ou VARIANT são adicionados a uma matriz. O valor padrão de Verdadeiro garante que uma nova cópia é feita de dados quando o elemento é adicionado à matriz.
Requisitos
Cabeçalho: atlsafe.h