TransportExpunge

This function expunges deleted messages out of specified folders on a mail server.

At a Glance

Header file:	Msgstor2.h
Platforms:	H/PC 3.0
Windows CE versions:	2.10 and later

Syntax

BOOL TransportExpunge( HANDLE hService, lpTransportFolderList pFolders);

Parameters

hService: [in] Handle to a private SERVICE structure.
pFolders: [in] Pointer to a TransportFolderList structure. This structure contains the list of folders to expunge messages from.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call the function TransportError or TransportErrorMsg.

Remarks

The transport service provider must implement this function in a DLL registered as a mail service. The Inbox application can then load this DLL and call this function.

TransportFolderList stores an array of TransportFolderInfo structures. This function uses the members of the TransportFolderInfo structures in the following ways:

Ignores szFriendlyName and fidStoreID
Uses szServiceId to uniquely identify folders