IPOutlookItemCollection::Add

9/8/2008

The Adicionar método cria um novo item para uma pasta na coleção de itens. Tipo de item depende de como tipo de pasta.

Syntax

HRESULT Add(
   IDispatch ** ppolItem
);

Parameters

• ppolItem
  [out] Referência ao novo item. For information about the VARIANT_BOOL type, see the union member of the PROPVARIANT structure.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  The method completed successfully.

Remarks

Esse método cria um item na memória. Você deve ainda salvar o item para a coleção.

Exemplo de código

O seguinte exemplo de código mostra como adicionar um item para uma coleção Items.

Observação

Para tornar o exemplo de código mais fácil para ler, verificação de segurança e manipulação de erro não estão incluídos.This code example should not be used in a release configuration unless it has been modified to include them.

void CreateTask(IPOutlookApp * polApp)
{
    IFolder                 * pFolder;
    IPOutlookItemCollection * pItems;
    ITask                   * pTask;

    polApp->GetDefaultFolder(olFolderTasks, &pFolder);

    pFolder->get_Items(&pItems);

    pItems->Add((IDispatch**)&pTask);

    // Commit the Task item to the Item Store.
    pTask->Save();

    // Release objects.
    pFolder->Release();
    pItems->Release();
    pTask->Release();
}

Requirements

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Tasks

Adding PIM Items to the Outlook Mobile Database

Reference

Pocket Outlook Object Model Interfaces

Other Resources