IMAPIFormMgr::SelectMultipleForms
Aplica-se a: Outlook 2013 | Outlook 2016
Apresenta uma caixa de diálogo que permite que o usuário selecione vários formulários e retorna uma matriz de objetos de informações de formulário que descrevem esses formulários.
HRESULT SelectMultipleForms(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFOARRAY pfrminfoarray,
LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai da caixa de diálogo exibida.
ulFlags
[in] Um bitmask de sinalizadores que controla o tipo de cadeias de caracteres passadas. O seguinte sinalizador pode ser definido:
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.
Psztitle
[in] Um ponteiro para uma cadeia de caracteres que contém o legenda da caixa de diálogo. Se o parâmetro pszTitle for NULL, o provedor de biblioteca de formulários que fornece os formulários fornecerá um legenda padrão.
pfld
[in] Um ponteiro para a pasta da qual selecionar os formulários. Se o parâmetro pfld for NULL, os formulários serão selecionados no contêiner de formulários local, pessoal ou de organização.
pfrminfoarray
[in] Um ponteiro para uma matriz de objetos de informações de formulário que são pré-selecionados para o usuário.
ppfrminfoarray
[out] Um ponteiro para um ponteiro para a matriz retornada de objetos de informações de formulário.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_BAD_CHARWIDTH
O sinalizador MAPI_UNICODE foi definido e a implementação não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e a implementação dá suporte apenas ao Unicode.
MAPI_E_USER_CANCEL
O usuário cancelou a operação, normalmente clicando no botão Cancelar na caixa de diálogo.
Comentários
Os visualizadores de formulários chamam o método IMAPIFormMgr::SelectMultipleForms para primeiro apresentar uma caixa de diálogo que permite que o usuário selecione vários formulários e, em seguida, recupere uma matriz de objetos de informações de formulário que descrevem os formulários selecionados. A caixa de diálogo SelectMultipleForms exibe todos os formulários, se eles estão ocultos ou não (ou seja, se suas propriedades ocultas estão ou não claras).
Observações para implementadores
Se um visualizador de formulários passar o sinalizador MAPI_UNICODE no parâmetro ulFlags , todas as cadeias de caracteres serão Unicode. Os provedores de biblioteca de formulários que não dão suporte a cadeias de caracteres Unicode devem retornar MAPI_E_BAD_CHARWIDTH se MAPI_UNICODE for aprovada.