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.
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 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
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
Reference
Pocket Outlook Object Model Interfaces