IAddrBook::Details

Aplica-se a: Outlook 2013 | Outlook 2016

Exibe uma caixa de diálogo que mostra detalhes sobre uma entrada específica do catálogo de endereços.

HRESULT Details(
  ULONG_PTR FAR * lpulUIParam,
  LPFNDISMISS lpfnDismiss,
  LPVOID lpvDismissContext,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPFNBUTTON lpfButtonCallback,
  LPVOID lpvButtonContext,
  LPSTR lpszButtonText,
  ULONG ulFlags
);

Parâmetros

lpulUIParam

[in] Um ponteiro para um identificador da janela pai da caixa de diálogo.

lpfnDismiss

[in] Um ponteiro para uma função com base no protótipo DISMISSMODELESS ou NULL. Esse membro aplica-se apenas à versão modeless da caixa de diálogo, conforme indicado pelo sinalizador DIALOG_SDI que está sendo definido. MAPI chama a função DISMISSMODELESS quando o usuário descarta a caixa de diálogo endereço modeless, informando a um cliente que está chamando Detalhes de que a caixa de diálogo não está mais ativa.

lpvDismissContext

[in] Um ponteiro para informações de contexto a serem passadas para a função DISMISSMODELESS apontada pelo parâmetro lpfnDismiss . Esse parâmetro se aplica apenas à versão modeless da caixa de diálogo, incluindo o sinalizador DIALOG_SDI no parâmetro ulFlags .

cbEntryID

[in] A contagem de bytes no identificador de entrada apontada pelo parâmetro lpEntryID .

Lpentryid

[in] Um ponteiro para o identificador de entrada para a entrada para a qual os detalhes são exibidos.

lpfButtonCallback

[in] Um ponteiro para uma função com base no protótipo da função LPFNBUTTON . Uma função LPFNBUTTON adiciona um botão à caixa de diálogo detalhes.

lpvButtonContext

[in] Um ponteiro para dados que foi usado como parâmetro para a função especificada pelo parâmetro lpfButtonCallback .

lpszButtonText

[in] Um ponteiro para uma cadeia de caracteres que contém texto a ser aplicado ao botão adicionado, se esse botão for extensível. O parâmetro lpszButtonText deve ser NULL se você não precisar de um botão extensível.

ulFlags

[in] Um bitmask de sinalizadores que controla o tipo do texto para o parâmetro lpszButtonText . Os seguintes sinalizadores podem ser definidos:

AB_TELL_DETAILS_CHANGE

Indica que os detalhes retornam S_OK se as alterações forem realmente feitas no endereço; caso contrário, Os detalhes retornam S_FALSE.

DIALOG_MODAL

Exiba a versão modal da caixa de diálogo endereço comum, que sempre é mostrada em clientes que não são do Outlook. Este sinalizador é mutuamente exclusivo com DIALOG_SDI.

DIALOG_SDI

Exiba a versão de modelagem da caixa de diálogo endereço comum. Esse sinalizador é ignorado para clientes que não são do Outlook.

MAPI_UNICODE

As cadeias de caracteres passadas estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.

Valor de retorno

S_OK

A caixa de diálogo detalhes foi exibida com êxito para a entrada do catálogo de endereços.

Comentários

Os aplicativos cliente chamam o método Detalhes para exibir uma caixa de diálogo que fornece detalhes sobre uma entrada específica no catálogo de endereços. Você pode usar os parâmetros lpfButtonCallback, lpvButtonContext e lpszButtonText para adicionar um botão definido pelo cliente à caixa de diálogo. Quando o botão é clicado, MAPI chama a função de retorno de chamada apontada por lpfButtonCallback, passando o identificador de entrada do botão e os dados em lpvButtonContext. Se você não precisar de um botão extensível, lpszButtonText deverá ser NULL.

Os detalhes dão suporte a cadeias de caracteres Unicode; As cadeias de caracteres Unicode são convertidas no formato MBCS (cadeia de caracteres multibyte) antes de serem exibidas na caixa de diálogo de detalhes.

Referência do MFCMAPI

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

Confira também

ADRPARM

IAddrBook::Address

LPFNBUTTON

IAddrBook : IMAPIProp

MFCMAPI como exemplo de código