Partilhar via


CComSafeArray::Add

Adiciona um ou mais elementos ou um SAFEARRAY estrutura, um 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 SAFEARRAY objeto.

  • ulCount
    O número de objetos para adicionar à matriz.

  • pT
    Um ponteiro para um ou mais objetos a ser adicionado à 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 é TRUE.

Valor de retorno

Retorna S_OK sucesso ou um erro HRESULT, em caso de falha.

Comentários

Os novos objetos são acrescentados ao participante do existente SAFEARRAY objeto.Adicionar um objeto a um multidimensional SAFEARRAYNão há suporte para o objeto .Ao adicionar uma matriz de objetos existente, as duas matrizes devem conter elementos do mesmo tipo.

The bCopy sinalizar é levado em conta quando elementos do tipo BSTR ou VARIANTE são adicionados a uma matriz.O valor padrão de TRUE garante que é feita uma nova cópia dos dados quando o elemento é adicionado à matriz.

Anotações Developer Dispositivo Inteligente

CComSafeArray::Add (SAFEARRAY *) tem suporte para apenas VT_BSTR, VT_VARIANT, VT_UNKNOWN e VT_DISPATCH VARTYPEs.

Requisitos

Cabeçalho: atlsafe.h

Consulte também

Referência

Classe CComSafeArray

Outros recursos

CComSafeArray membros