MailSwitchToFolder

9/8/2008

The MailSwitchToFolder função alterna para uma pasta e exibirá seu conteúdo em uma lista-Modo de exibição. Para obter mais informações sobre o controle List View, consulte o List-View Controls Reference.

Syntax

HRESULT MailSwitchToFolder(
    LPENTRYID lpEntryID,
    ULONG cbEntryID
);

Parameters

• lpEntryID
  [no] Referência para o ENTRYID da pasta para exibir em um List View.

• cbEntryID
  [no] Tamanho das EntryID estrutura, em bytes.

Return Value

Essa função retorna o padrão valores E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Chamar a função com êxito.

Remarks

Porque os nomes dos pasta não podem ser exclusivo entre diferentes contas, a pasta deve ser especificada por ENTRYID em vez de por nome. Se não houver nenhuma pasta com a ENTRYID especificado, essa função retornará um erro.

Essa função é síncrono. Quando essa função retorna, a pasta especificada é mostrada na lista-exibição.

Se você não tiver um ponteiro armazenar mensagem, você poderá get um ENTRYID para transmitir para MailSwitchToFolder Usando o ponteiro ICEMAPISession. O IMAPISession::GetMsgStoresTable retorna uma lista de armazenamentos mensagem. Você pode usar na interface para IMsgStore::GetReceiveFolder IMsgStore get a EntryID do Caixa de Entrada associado com a armazenar mensagem você desejar. Se você desejar outra pasta, consulta armazenar a mensagem para propriedades such as PR_IPM_OUTBOX_ENTRYID PR_IPM_WASTEBASKET_ENTRYIDe PR_IPM_SENTMAIL_ENTRYID. Como alternativa, você pode usar métodos MAPI para percorrer a hierarquia da Caixa de Entrada para pastas filho.

Requirements

Header	cemapi.h
Library	cemapi.lib
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

MAPI Functions
PR_ENTRYID
IMAPISession::GetMsgStoresTable

Other Resources

Messaging