IProfAdmin::AdminServices
Aplica-se a: Outlook 2013 | Outlook 2016
Fornece acesso a um objeto de administração de serviço de mensagem para fazer alterações nos serviços de mensagem em um perfil.
HRESULT AdminServices(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPSERVICEADMIN FAR * lppServiceAdmin
);
Parâmetros
Lpszprofilename
[in] Um ponteiro para o nome do perfil a ser modificado. O parâmetro lpszProfileName não deve ser NULL.
lpszPassword
[in] Sempre NULL.
ulUIParam
[in] Um identificador da janela pai para quaisquer caixas de diálogo ou janelas exibidas por esse método.
ulFlags
[in] Um bitmask de sinalizadores que controla a recuperação do objeto de administração do serviço de mensagem. Os seguintes sinalizadores podem ser definidos:
MAPI_DIALOG
Habilita a exibição de uma interface do usuário.
MAPI_UNICODE
O nome do perfil está no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, o nome estará no formato ANSI.
lppServiceAdmin
[out] Um ponteiro para um ponteiro para um objeto de administração de serviço de mensagem.
Valor de retorno
S_OK
O objeto de administração do serviço de mensagem foi retornado com êxito.
MAPI_E_LOGON_FAILED
O perfil especificado não existe ou a senha estava errada e uma caixa de diálogo não pôde ser exibida ao usuário para solicitar a senha correta porque MAPI_DIALOG não foi definido em ulFlags.
MAPI_E_USER_CANCEL
O usuário cancelou a operação, normalmente clicando no botão Cancelar em uma caixa de diálogo.
Comentários
O método IProfAdmin::AdminServices fornece acesso a um objeto de administração do serviço de mensagem para fazer alterações de configuração nos serviços de mensagem em um perfil.
O parâmetro lpszPassword deve ser NULL ou um ponteiro para uma cadeia de caracteres de comprimento zero.
Notas para chamadores
Embora você possa recuperar um ponteiro IMsgServiceAdmin chamando esse método ou IMAPISession::AdminServices, chame IProfAdmin::AdminServices se você tiver estritamente um cliente de configuração e não oferecer recursos de mensagens. IProfAdmin::AdminServices não cria um objeto de sessão e não carrega nenhum provedor de serviços, o que melhora o desempenho.
Você não pode usar IProfAdmin::AdminServices para criar um perfil. Portanto, você deve especificar um perfil válido existente no lpszProfileName. Se o perfil especificado não existir, IProfAdmin::AdminServices retornará MAPI_E_LOGON_FAILED.
O nome do perfil pode ter até 64 caracteres de comprimento e pode incluir os seguintes caracteres:
Todos os caracteres alfanuméricos, incluindo caracteres de ênfase e o caractere sublinhado.
Espaços inseridos, mas não espaços à frente ou à direita.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
O MFCMAPI usa o método IProfAdmin::AdminServices para abrir um objeto de administração do serviço de mensagem para o perfil selecionado para adicionar serviços. |