IMsgServiceAdmin::CopyMsgService
Aplica-se a: Outlook 2013 | Outlook 2016
Copia um serviço de mensagem em um perfil.
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parâmetros
lpUID
[in] Um ponteiro para a estrutura MAPIUID que contém o identificador exclusivo do serviço de mensagem a ser copiado.
lpszDisplayName
[in] Esse parâmetro foi preterido.
lpInterfaceToCopy
[in] Um ponteiro para o IID (identificador de interface) que representa a interface a ser usada para acessar a seção de perfil do serviço de mensagem a ser copiada. Passar NULL resulta na interface da seção de perfil padrão, IProfSect, que está sendo usada.
lpInterfaceDst
[in] Um ponteiro para o IID que representa a interface a ser usada para acessar o objeto apontado pelo parâmetro lpObjectDst . Passar NULL resulta na interface da sessão, IMAPISession, que está sendo usada. O parâmetro lpInterfaceDst também pode ser definido como IID_IMsgServiceAdmin.
lpObjectDst
[in] Um ponteiro para um ponteiro para um objeto de administração de serviço de sessão ou mensagem. O tipo de objeto deve corresponder ao identificador de interface passado em lpInterfaceDst. Os ponteiros de objeto válidos são LPMAPISESSION e LPSERVICEADMIN.
ulUIParam
[in] Um identificador para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe.
ulFlags
[in] Um bitmask de sinalizadores que controla como o serviço de mensagem é copiado. Os seguintes sinalizadores podem ser definidos:
SERVICE_UI_ALWAYS
Solicita que o serviço de mensagem sempre exiba uma folha de propriedades de configuração.
Valor de retorno
S_OK
O serviço de mensagem foi copiado com êxito.
MAPI_E_NO_ACCESS
O serviço de mensagem já está no perfil e não permite várias instâncias de si mesmo.
MAPI_E_NOT_FOUND
O MAPIUID apontado por lpUID não se refere a um serviço de mensagem existente.
Comentários
O método IMsgServiceAdmin::CopyMsgService copia um serviço de mensagem em um perfil, seja o perfil ativo ou outro perfil. O perfil que contém o serviço de mensagem a ser copiado e o destino não precisam ser o mesmo perfil, mas podem ser.
A função de ponto de entrada do serviço de mensagem não é chamada para uma operação de cópia. O serviço de mensagem copiado tem as mesmas configurações que o original. Para alterar essas configurações, um cliente deve chamar o método IMsgServiceAdmin::ConfigureMsgService .