Folder Properties

The SmsEnumFolders function enables your application to get information about the folder types supported by a specific container or folder. SmsEnumFolders retrieves information about all folder types supported by the SMS API. The properties for each folder type are stored in a FOLDER_INFO structure.

By accessing the members of the FOLDER_INFO structure, your application can get the following information about the folder type:

tObjectity

Specifies the type of object. For folders, the type of object is T_FOLDER. See BASETYPE.

Because the FOLDER_INFO structure is used to describe both containers and folders, this member indicates which of these types is being described.

pszTag

Points to the string form of the folder's tag.

dwTag

Specifies the integer form of the folder's tag.

ctFolders

Specifies the number of subfolder types that the specified folder supports. Note that ctFolders specifies the types of folders that the specified folder is capable of containing—not the number of actual subfolders contained within a specific folder.

pFolderTags

Points to an array of DWORD values that indicate the types of subfolders supported by the folder.

ctFilters

Specifies the number of filter types that the specified folder or container supports.

pFilterTags

Points to an array of DWORD values that indicate the types of filters supported by the folder.

ctScalars

Specifies the number of scalars that the specified folder supports.

pScalars

Points to an array of SCALAR_INFO structures that describe the scalars supported by the folder.

You can also use the SmsDescribeFolder function to retrieve information about an individual folder type. SmsEnumFolderTypes retrieves information about the folder types for a specific container or folder. SmsGetFolderCount retrieves the count of actual subfolders contained within a folder or container.