Compartilhar via


IMAPIForm::GetViewContext

Aplica-se a: Outlook 2013 | Outlook 2016

Retorna o contexto de exibição atual para o formulário.

HRESULT GetViewContext(
  LPMAPIVIEWCONTEXT FAR * ppViewContext
);

Parâmetros

ppViewContext

[out] Um ponteiro para um ponteiro para o contexto de exibição do formulário.

Valor de retorno

S_OK

O contexto de exibição atual do formulário foi retornado com êxito.

S_FALSE

Não há contexto de exibição para o formulário.

Comentários

Os visualizadores de formulários chamam GetViewContext para obter um ponteiro para o contexto de exibição estabelecido em uma chamada anterior para IMAPIForm::SetViewContext. Se nenhuma chamada anterior tiver sido feita para SetViewContext, GetViewContextdefinirá ppViewContext como NULL.

Observações para implementadores

Copie o ponteiro de contexto de exibição do formulário no ponteiro passado pelo visualizador de formulário de chamada no parâmetro ppViewContext . Se o formulário não tiver um contexto de exibição, defina ppViewContext como NULL.

Referência do MFCMAPI

Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.

Arquivo Função Comentário
MAPIFormFunctions.cpp
OpenMessageNonModal
O MFCMAPI usa o método IMAPIForm::GetViewContext para marcar se um formulário tem um contexto de exibição.

Confira também

IMAPIViewContext : IUnknown

IMAPIForm : IUnknown

MFCMAPI como exemplo de código