IMsgStore::OpenEntry

9/8/2008

The OpenEntry método abre um objeto armazenar mensagem e retorna um ponteiro interface para acessar mais.

Syntax

HRESULT OpenEntry (
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parameters

• cbEntryID
  [no] Contagem de bytes no identificador de entrada apontado pelo lpEntryID.

• lpEntryID
  [no] Referência ao identificador de entrada do objeto para aberto; não pode ser NULL.

• lpInterface
  [no] Ignorado.

• ulFlags
  [no] Ignorado.

• lpulObjType
  [out] Referência de tipo do objeto aberto.

• lppUnk
  [out] Referência a objeto aberto.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Indica sucesso.

• MAPI_E_NO_ACCESS
  Houve uma tentativa para modificar um objeto READ-ONLY ou para acessar um objeto para que o usuário possui permissões insuficientes.

Remarks

OpenEntry Abre um objeto armazenar mensagem, objeto pasta ou objeto mensagem e retorna um ponteiro que pode ser usado para acessar o objeto, descrito a seguinte tabela:

Objeto aberto	**lppUnk objeto interface	*lpulObjType
armazenar mensagem	IMsgStore	Não definido
pasta	IMAPIFolder	MAPI_FOLDER
mensagem	IMessage	MAPI_MESSAGE

Todos os MAPI OpenEntry chamar métodos Down to subjacente a mesma função auxiliar, portanto, não existe nenhum desempenho ocorrência na escolha IMsgStore::OpenEntry Sobre IMAPISession::OpenEntry ou ISpTTSEngine::Speak. IMAPIFolder::OpenEntry (que é acessível através de IMAPIContainer::OpenEntry).

Chamando OpenEntry e configuração lpEntryID Para apontar para o identificador entrada de uma mensagem é armazenar equivalente para chamado de IMAPISession::OpenMsgStore método).

Verifique o valor retornado na lpulObjType parâmetro determinar se o tipo de objeto retornado é o que você esperava. Se o tipo objeto não for o tipo esperado, CAST o ponteiro a partir de lppUnk parâmetro para um ponteiro do apropriado tipo. De exemplo, se você está abrindo uma pasta, CAST lppUnk Para um ponteiro de tipo LPMAPIFOLDER.

Quando você terminar Usando o objeto relacionado por lppUnk, você deve livre sua memória por chamado seu Lançamento método).

Requirements

Header	mapidefs.h
Library	cemapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPIContainer::OpenEntry
IMAPISession::OpenEntry
IMsgStore

Other Resources

Messaging