IMsgServiceAdmin::AdminProviders
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna um ponteiro que fornece acesso a um objeto de administração do provedor.
HRESULT AdminProviders(
LPMAPIUID lpUID,
ULONG ulFlags,
LPPROVIDERADMIN FAR * lppProviderAdmin
);
Parâmetros
lpUID
[in] Um ponteiro para a estrutura MAPIUID que contém o identificador exclusivo para o serviço de mensagem a ser administrado.
ulFlags
[in] Sempre NULL.
lppProviderAdmin
[out] Um ponteiro para um ponteiro para um objeto de administração do provedor.
Valor de retorno
S_OK
O objeto de administração do provedor foi retornado com êxito.
MAPI_E_NOT_FOUND
O MAPIUID apontado por lpUID não existe.
Comentários
O método IMsgServiceAdmin::AdminProviders fornece acesso a um objeto de administração do provedor. Uma administração de provedor é um objeto que dá suporte à interface IProviderAdmin e permite que os clientes façam o seguinte:
Adicione provedores de serviço a um serviço de mensagem.
Excluir provedores de serviço de um serviço de mensagem.
Abra seções de perfil.
Acesse a tabela do provedor de serviços de mensagem.
Os tipos de alterações que podem realmente ser feitas em um serviço de mensagem enquanto o perfil estiver em uso dependem do serviço de mensagem. No entanto, a maioria dos serviços de mensagem não dá suporte a alterações, como adicionar e excluir provedores enquanto o perfil estiver em uso.
Notas para chamadores
Para recuperar a estrutura MAPIUID para o serviço de mensagem a ser administrado, recupere a coluna de propriedade PR_SERVICE_UID (PidTagServiceUid) da linha do serviço de mensagem na tabela de serviço de mensagem. Para obter mais informações, consulte o procedimento descrito no método IMsgServiceAdmin::CreateMsgService .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDisplayItem |
O MFCMAPI usa o método IMsgServiceAdmin::AdminProviders para abrir um objeto de administração de provedor para um serviço. |