IMAPIContainer::GetHierarchyTable (Compact 7)
3/12/2014
The GetHierarchyTable method returns a pointer to the container's hierarchy table.
Syntax
HRESULT GetHierarchyTable (
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
- ulFlags
[in] Ignored.
- lppTable
[out] Reference to the hierarchy table object, implemented on IMAPITable.
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.
- MAPI_E_NO_SUPPORT
The container has no child containers and cannot provide a hierarchy table.
Remarks
The GetHierarchyTable method returns a pointer to the container's hierarchy table, which holds summary information about the child containers within the container. For example, folder hierarchy tables hold information about child folders.
Containers that have no child containers return MAPI_E_NO_SUPPORT from their implementations of GetHierarchyTable.
The following IMAPITable methods are supported for folder hierarchy tables in Windows Embedded Compact Messaging:
String and binary contents table columns can be truncated. Typically, providers return 255 characters. Because you cannot know ahead of time whether or not a table includes truncated columns, assume that a column is truncated if the length of the column is either 255 or 510 bytes. You can always retrieve the full value of a truncated column from the object directly by using its entry identifier to open it and then calling the IMAPIProp::GetProps method.
Depending on the provider implementation, restrictions and sorting operations can apply to an entire string or to the truncated version of that string.
Requirements
Header |
mapidefs.h |
Library |
cemapi.lib |