IMSLogon::OpenStatusEntry
Aplica-se a: Outlook 2013 | Outlook 2016
Abre um objeto status.
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPVOID FAR * lppEntry
);
Parâmetros
lpInterface
[in] Um ponteiro para o IID (identificador de interface) para o objeto status abrir. Passar NULL indica que a interface padrão do objeto é retornada (nesse caso, a interface IMAPIStatus ). O parâmetro lpInterface também pode ser definido como um identificador para uma interface apropriada para o objeto.
ulFlags
[in] Um bitmask de sinalizadores que controla como o objeto status é aberto. O seguinte sinalizador pode ser definido:
MAPI_MODIFY
Solicita permissão de leitura/gravação. Por padrão, os objetos são criados com permissão somente leitura e os aplicativos cliente não devem funcionar na suposição de que a permissão de leitura/gravação foi concedida.
lpulObjType
[out] Um ponteiro para o tipo do objeto aberto.
lppEntry
[out] Um ponteiro para o ponteiro para o objeto aberto.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Os provedores do repositório de mensagens implementam o método IMSLogon::OpenStatusEntry para abrir um objeto status. Esse objeto status é usado para permitir que os clientes chamem métodos IMAPIStatus. Por exemplo, os clientes podem usar o método IMAPIStatus::SettingsDialog para reconfigurar a sessão de logon do repositório de mensagens ou o método IMAPIStatus::ValidateState para validar o estado da sessão de logon do repositório de mensagens.