IPOutlookApp

9/8/2008

The IPOutlookApp interface representa o objeto aplicativo Outlook Mobile. Esse objeto atende a seguinte finalidades:

• Como o objeto raiz, ele fornece acessar a todos os outros objetos na hierarquia de POOM.
• Ele fornece acesso direto recém-criado itens, sem ter de atravessar a hierarquia objeto.
• Ele fornece acesso direto aos itens existentes.

Um aplicativo cria essa interface, chamado CoCreateInstance, usando o CLSID_Application identificador exclusivo (GUID) e recebe uma referência a um objeto aplicativo. O objeto aplicativo é o único objeto POOM recuperado com CoCreateInstance.

Métodos na ordem TabelaV

• IUnknown métodos
• IDispatch métodos

Métodos IPOutlookApp	Description
IPOutlookApp::Logon	Registra o usuário on to um POOM Session.
IPOutlookApp::Logoff	Registra o usuário off of um POOM Session.
IPOutlookApp::get_Version	Obtém uma seqüência de caracteres three-Part descrevendo a versão do Outlook Mobile (ou de Pocket Outlook) que está em uso.
IPOutlookApp::GetDefaultFolder	Obtém um objeto IFolder para uma das cinco pastas fornecidas pelo Outlook Mobile.
IPOutlookApp::CreateItem	Cria e obtém um POOM item.
IPOutlookApp::GetItemFromOid	Recupera o item especificado por um identificador objeto Windows Embedded CE (OID).
IPOutlookApp::get_HomeCity	Obtém um objeto ICity representando cidade residencial do usuário a.
IPOutlookApp::put_HomeCity	Define um objeto ICity representando cidade residencial do usuário a.
IPOutlookApp::get_VisitingCity	Obtém um objeto ICity que representa a cidade em que o usuário está visitando atualmente.
IPOutlookApp::put_VisitingCity	Define um objeto ICity que representa a cidade em que o usuário está visitando atualmente.
IPOutlookApp::get_CurrentCityIndex	Obtém ou IPOutlookApp::get_HomeCity IPOutlookApp::get_VisitingCity, dependendo se o atual cidade em uso por World Clock é a cidade residencial ou de visita.
IPOutlookApp::put_CurrentCityIndex	Define ou IPOutlookApp::get_HomeCity IPOutlookApp::get_VisitingCity, dependendo se o atual cidade em uso por World Clock é a cidade residencial ou de visita.
IPOutlookApp::ReceiveFromInfrared	Inicia recepção de um item em um link de infravermelho.
IPOutlookApp::get_OutlookCompatible	Retorna TRUE Se o dispositivo móvel é parceria com um computador desktop execução Outlook e retorna FALSE Se o computador desktop é execução Schedule +.
IPOutlookApp::GetTimeZoneFromIndex	Usa um índice zona de tempo para retornar um objeto para o correspondente ITimeZone zona de tempo.
IPOutlookApp::GetTimeZoneInformationFromIndex	Usa um índice zona de tempo para get a estrutura TIME_ZONE_INFORMATION (declarado no winbase.h) para o correspondente zona de tempo.
IPOutlookApp::get_Application	Obtém o objeto aplicativo Outlook Mobile principal.
IPOutlookApp::SysFreeString	Libera um seqüência de caracteres que foi anteriormente alocado.
IPOutlookApp::VariantTimeToSystemTime	Converte a representação Variant de tempo para equivalente hora do sistema seu.
IPOutlookApp::SystemTimeToVariantTime	Converte um objeto hora do sistema para equivalente Variant seu.

Example

O seguinte exemplo mostra como criar um objeto aplicativo Outlook Mobile, log e exibir a versão Outlook Mobile.

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.

#define INITGUID
#include <windows.h>
#include <pimstore.h>

HRESULT        hr;
IPOutlookApp * polApp;

// Initialize COM.
CoInitializeEx(NULL, 0);

// Get the Outlook Mobile application object.
hr = CoCreateInstance(CLSID_Application, NULL, CLSCTX_INPROC_SERVER, IID_IPOutlookApp, (LPVOID*)&polApp);

// Log on to POOM.
hr = polApp->Logon(NULL);

// Get the Outlook Mobile version, and display it in a message box.
BSTR pwszVersion = NULL;
polApp->getVersion(&pwszVersion);
MessageBox(NULL, pwszVersion, TEXT("Outlook Mobile Version"), MB_SETFOREGROUND | MB_OK);

// Free the version string.
SysFreeString(pwszVersion);
// Note: For Microsoft Palm-size PC 1.0, use the Application method:
// polApp->SysFreeString(pwszVersion).
// Log off and release the POOM application object.
polApp->Logoff();
polApp->Release();

Requisitos

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

Reference

Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations