Platform SDK: Exchange Server

HrMAPIFindFolderEx

The HrMAPIFindFolderEx function retrieves a folder in an information store using the hierarchical path name of the folder.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB
Unicode: Yes

HRESULT HrMAPIFindFolderEx(
  LPMDB lpMdb,            
  TCHAR chSep,            
  LPTSTR lpszFolderPath,  
  ULONG * lpcbeid,        
  LPENTRYID * lppeid      
);
 

Parameters

lpMdb
Input parameter. Points to a MAPI IMsgStore interface containing the open information store.
chSep
Input parameter. Folder path separator character.
lpszFolderPath
Input parameter. Folder path.
lpcbeid
Output parameter. Points to count of bytes in the entry identifier.
lppeid
Output parameter. Points to the address where the MAPI ENTRYID structure containing the entry identifier is stored.

Return Values

See Return Values.

Remarks

To open the root folder, set the value of lpMdp to NULL.

For more information on this function, see Opening an Existing Private or Personal Folder.

For information on the ENTRYID structure and IMsgStore interface, see the MAPI Programmer's Reference.

See Also

HrMAPIFindFolder, HrMAPIFindSubfolderEx, HrMAPIOpenFolderEx