IMAPISupport::OpenProfileSection
Aplica-se a: Outlook 2013 | Outlook 2016
Abre uma seção do perfil atual e retorna um ponteiro IProfSect para obter mais acesso.
HRESULT OpenProfileSection(
LPMAPIUID lpUid,
ULONG ulFlags,
LPPROFSECT FAR * lppProfileObj
);
Parâmetros
lpUid
[in] Um ponteiro para a estrutura MAPIUID que identifica a seção de perfil a ser aberta. Passar NULL para o parâmetro lpUid abre a seção de perfil do chamador.
ulFlags
[in] Um bitmask de sinalizadores que controla como a seção de perfil é aberta. Os seguintes sinalizadores podem ser definidos:
MAPI_DEFERRED_ERRORS
Permite que OpenProfileSection retorne com êxito , possivelmente antes que a seção de perfil esteja totalmente acessível ao chamador. Se a seção de perfil não estiver acessível, fazer uma chamada de objeto subsequente poderá resultar em um erro.
MAPI_MODIFY
Solicita permissão de leitura/gravação. Por padrão, os objetos são abertos como somente leitura e os chamadores não devem trabalhar na suposição de que a permissão de leitura/gravação foi concedida.
lppProfileObj
[out] Um ponteiro para um ponteiro para a seção de perfil aberto.
Valor de retorno
S_OK
A seção de perfil foi aberta com êxito.
MAPI_E_NO_ACCESS
Foi feita uma tentativa de modificar uma seção de perfil somente leitura ou acessar um objeto para o qual o chamador não tem permissões suficientes.
MAPI_E_NOT_FOUND
Não há uma seção de perfil associada ao identificador de entrada passado em lpEntryID.
MAPI_E_UNKNOWN_FLAGS
Sinalizadores reservados ou sem suporte foram usados e, portanto, a operação não foi concluída.
Comentários
O método IMAPISupport::OpenProfileSection é implementado para todos os objetos de suporte. Provedores de serviços e serviços de mensagem chamam OpenProfileSection para abrir uma seção de perfil e recuperar um ponteiro para sua implementação de interface IProfSect .
Notas para chamadores
OpenProfileSection abre seções de perfil como somente leitura, a menos que você defina o sinalizador MAPI_MODIFY no parâmetro ulFlags e sua permissão seja suficiente. Definir esse sinalizador não garante a permissão de leitura/gravação; as permissões concedidas dependem do nível de acesso e do objeto.
Se OpenProfileSection tentar abrir uma seção de perfil inexistente como somente leitura, ele retornará MAPI_E_NOT_FOUND. Se OpenProfileSection tentar abrir uma seção de perfil inexistente como leitura/gravação, ele criará a seção de perfil e retornará o ponteiro IProfSect .