IXPLogon::OpenStatusEntry
Aplica-se a: Outlook 2013 | Outlook 2016
Abre o objeto status do provedor de transporte.
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPMAPISTATUS FAR * lppEntry
);
Parâmetros
lpInterface
[in] Um ponteiro para um IID (identificador de interface) para o objeto logon de transporte. Passar NULL retorna a interface IMAPIStatus . O parâmetro lpInterface também pode ser definido como um identificador para uma interface 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. A interface padrão é somente leitura.
lpulObjType
[out] Um ponteiro para o tipo do objeto aberto.
lppEntry
[out] Um ponteiro para o ponteiro para o objeto status aberto.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
O spooler MAPI chama o método IXPLogon::OpenStatusEntry quando um aplicativo cliente chama um método OpenEntry para o identificador de entrada na linha de tabela status do provedor de transporte. OpenStatusEntry abre um objeto com a interface IMAPIStatus associada a esse logon do provedor de transporte específico. Esse objeto é então usado para permitir que aplicativos cliente chamem métodos IMAPIStatus (por exemplo, para reconfigurar a sessão de logon usando o método IMAPIStatus::SettingsDialog ou para validar o estado da sessão de logon usando o método IMAPIStatus::ValidateState ).