Ler em inglês

Compartilhar via


Adicionar

Adiciona um perfil à coleção.

Sintaxe

HRESULT Add
  ([in] IProfile* pProfile,
  [in] VARIANT_BOOL fMerge)
;

Parâmetros

pProfile
[in] Um ponteiro para um objeto IProfile a ser adicionado à coleção.

fMerge
[in] Um valor booliano que indica se o pProfile deve ser mesclado com um na coleção com o mesmo nome. Se um perfil mutável estiver na coleção e esse parâmetro for definido como TRUE, os perfis serão mesclados. Caso contrário, o método retornará um erro. Se a coleção não tiver um perfil com o mesmo nome, o método ignorará esse parâmetro e adicionará o perfil à coleção.

Valor Retornado

A tabela a seguir descreve possíveis valores retornados.

Valor Retornado Descrição

S_OK

A função adicionou com êxito o perfil à coleção.

E_INVALIDARG

Um ou mais argumentos são inválidos. Use IErrorInfo para obter informações detalhadas de erro.

E_WPRC_FAILED_TO_ADD_PROFILE

Falha na biblioteca ao adicionar um perfil à coleção. Use IErrorInfo para obter informações detalhadas de erro.

IProfileCollection