Platform SDK: Exchange Server

HrMAPIFindFolder

The HrMAPIFindFolder function retrieves a folder by name.

Quick Info

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

HRESULT HrMAPIFindFolder(
  LPMAPIFOLDER lpFolder,  
  LPTSTR lpszName,        
  ULONG * lpcbeid,        
  LPENTRYID * lppeid      
);

Parameters

lpFolder: Input parameter. Points to a MAPI IMAPIFolder interface containing the folder.
lpszName: Input parameter. Name of the folder to find.
lpcbeid: Output parameter. Points to the 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

For more information on this function, see the HrMAPIFindFolder 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

HrMAPIFindFolderEx, HrMAPIFindSubfolderEx, HrMAPIOpenFolderEx