Compartilhar via


IMAPIFormInfo::SaveForm

Aplica-se a: Outlook 2013 | Outlook 2016

Salva uma descrição de um formulário específico em um arquivo de configuração.

HRESULT SaveForm(
  LPCSTR szFileName
);

Parâmetros

szFileName

[in] Uma cadeia de caracteres que nomeia o arquivo de mensagem de descrição do formulário em que sua descrição é salva. Esse nome de arquivo deve ter a extensão .fdm.

Valor de retorno

S_OK

A chamada foi bem-sucedida e retornou o valor ou valores esperados.

MAPI_E_EXTENDED_ERROR

O arquivo de configuração não pôde ser gravado. Para obter a estrutura MAPIERROR associada ao erro, chame o método IMAPIProp::GetLastError .

MAPI_E_NO_SUPPORT

SaveForm provavelmente foi chamado para salvar um formulário no contêiner de formulário local. Não há suporte para SaveForm no contêiner de formulário local.

Comentários

Os aplicativos cliente chamam o método IMAPIFormInfo::SaveForm para salvar uma descrição do formulário atual no arquivo que tem o nome do arquivo fornecido. SaveForm cria um arquivo de configuração.

Notas para chamadores

Você pode reinstalar formulários selecionando-os em uma lista de mensagens de descritor de formulário em uma caixa de diálogo que os provedores de biblioteca de formulários exibem. A extensão recomendada para mensagens de descritor de formulário é .fdm.

Chame o método IMAPIProp::GetLastError se o SaveForm retornar MAPI_E_EXTENDED_ERROR e marcar a estrutura MAPIERROR retornada para determinar a condição que causou o erro.

Confira também

IMAPIProp::GetLastError

MAPIERROR

IMAPIFormInfo : IMAPIProp