IContact::Save

9/8/2008

The Salvar método salva um contato item.

Syntax

HRESULT Save(void);

Return Value

Após bem-sucedido conclusão, esse método retorna o padrão HRESULT valor S_OK, caso contrário, retornará o seguinte:

• E_FAIL
  O contato item não puderam ser salvas para o banco de dados.

• E_INVALIDARG
  O argumento é inválido.

• E_OUTOFMEMORY
  Executei memória insuficiente.

• E_UNEXPECTED
  Ocorreu um erro inesperado.

• S_FALSE
  Este pode ocorrer por vários motivos. De exemplo, se o contato não puder ser encontrado item, se o banco de dados não podem ser atualizado, ou se as informações FileAs não podem ser geradas.

Remarks

Para salvar um contato, você deve especificar at least um do seguinte quatro propriedades: Nome, Sobrenome, CompanyName GPSGetPosition, e FileAs.

Exemplo de código

O seguinte exemplo de código cria e salva um novo contato.

void SaveContact(IPOutlookApp * polApp)
{
    IContact                * pContact;
    IFolder                 * pFolder;
    IPOutlookItemCollection * pItems;

    // Create a new contact.
    polApp->GetDefaultFolder(olFolderContacts, &pFolder);
    pFolder->get_Items(&pItems);
    pItems->Add(&pContact);

    pContact->put_FirstName(TEXT("Brian"));
    pContact->put_LastName(TEXT("Fleming"));
    pContact->put_Company(TEXT("Microsoft"));
    pContact->put_FileAs(TEXT("Fleming"));

    // Save the new contact.
    pContact->Save();

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

Requirements

See Also

Tasks

Creating a PIM Item

Reference

Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations