IMsgStore::GetReceiveFolder
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 Values
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
Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h
Library: cemapi.lib
See Also
IMsgStore | MAPIFreeBuffer | Messaging
Send Feedback on this topic to the authors