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