Share via


IMsgStore::GetReceiveFolder (Compact 7)

3/12/2014

The GetReceiveFolder method obtains the folder that was established as the destination for incoming messages of a specified message class or the default receive folder for the message store.

Syntax

HRESULT GetReceiveFolder (
  LPTSTR lpszMessageClass,
  ULONG ulFlags,
  ULONG FAR * lpcbEntryID,
  LPENTRYID FAR * lppEntryID,
  LPTSTR FAR * lppszExplicitClass
);

Parameters

  • lpszMessageClass
    [in] Not used; must be NULL.
  • ulFlags
    [in] Not used; must be zero or MAPI_UNICODE.
  • lpcbEntryID
    [out] Reference to the count of bytes in the entry identifier pointed to by lppEntryID.
  • lppEntryID
    [out] Reference to the entry identifier for the requested receive folder.
  • lppszExplicitClass
    [out] Not supported; must be NULL.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    Indicates success.

Remarks

GetReceiveFolder obtains the entry identifier of a receive folder. You must specify NULL in the lpszMessageClass parameter. A default receive folder (obtained by passing NULL in the lpszMessageClass parameter) always exists for every message store.

To free the memory that holds that entry identifier, a client should call the MAPIFreeBuffer function when it is done with the entry identifier returned in lppEntryID.

Requirements

Header

mapidefs.h

Library

cemapi.lib

See Also

Reference

IMsgStore
MAPIFreeBuffer