HrOpenOfflineObj
Aplica-se a: Outlook 2013 | Outlook 2016
Abre um objeto offline com base em um determinado perfil.
Informações rápidas
| Propriedade | Valor |
|---|---|
| Exportado por: |
msmapi32.dll |
| Chamado por: |
Cliente |
| Implementado por: |
Outlook |
typedef HRESULT (STDMETHODCALLTYPE HROPENOFFLINEOBJ)(
ULONG ulReserved,
LPCWSTR pwszProfileNameIn,
const GUID* pGUID,
const GUID* pReserved,
IMAPIOfflineMgr** ppOfflineObj);
Parâmetros
ulReserved
[in] Este parâmetro não é usado. Deve ser 0.
pwszProfileNameIn
[in] O nome do perfil para o qual o objeto offline é. Ela deve ser expressa no Unicode.
Pguid
[in] Ponteiro para um GUID que pode ser usado para identificar exclusivamente esse objeto de outros objetos offline. Deve ser GUID_GlobalState.
Preservado
[in] Este parâmetro não é usado. Deve ser nulo.
ppOfflineObj
[out] Um ponteiro para o objeto offline solicitado. O chamador pode usar esse ponteiro para acessar a interface IMAPIOfflineMgr : IMAPIOffline para encontrar os retornos de chamada compatíveis com esse objeto e configurar retornos de chamada para ele.
Valores de retorno
S_OK
- A chamada de função é bem-sucedida.
MAPI_E_NOT_FOUND
- A chamada de função falhou.
Comentários
Essa é a primeira chamada que um cliente faz quando o cliente deseja ser notificado de qualquer alteração de estado de conexão para um determinado perfil. Ao chamar HrOpenOfflineObj, o cliente obtém um objeto offline que dá suporte a IMAPIOfflineMgr. O cliente pode marcar para os tipos de retornos de chamada compatíveis com o objeto (usando IMAPIOffline::GetCapabilities) e configurar retornos de chamada para ele (usando IMAPIOfflineMgr::Advise).
Ao usar GetProcAddress para procurar o endereço dessa função no msmapi32.dll, especifique HrOpenOfflineObj@20 como o nome do procedimento.
HrOpenOfflineObj funciona apenas para clientes que são provedores MAPI, Suplementos COM e Extensões de Cliente do Exchange em execução dentro do processo do Outlook. Caso contrário, HrOpenOfflineObjretornará MAPI_E_NOT_FOUND.