HrMAPIFindSubfolderEx

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

Quick Info

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

HRESULT HrMAPIFindSubfolderEx(
  LPMAPIFOLDER lpRootFolder,  
  TCHAR chSep,                
  LPCTSTR lpszName,           
  ULONG * lpcbeid,            
  LPENTRYID * lppeid          
);

Parameters

lpRootFolder
Input parameter. Points to a MAPI IMAPIFolder interface containing the open root folder.
chSep
Input parameter. Folder path separator character.
lpszName
Input parameter. Folder path.
lpcbeid
Output parameter. The size, in bytes, of the entry identifier specified in the lppeid parameter.
lppeid
Output parameter. Points to an ENTRYID structure containing the entry identifier for the folder.

Return Values

See Return Values.

Remarks

Pass a NULL value for lpMdp to open the root folder.

For more information on this function, see the HrMAPIFindSubfolderEx function in IFOLDER.C under the EDKMAPI code sample in the Code Samples folder.

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

See Also

HrMAPIFindFolder, HrMAPIFindFolderEx, HrMAPIOpenSubfolderEx