TransportPutFolder

This function creates a subfolder within a specified parent folder on a mail server.

At a Glance

Syntax

BOOL TransportPutFolder(HANDLE hService, LPWSTR szFolderName,
LPWSTR szParentID, LPWST*pszCreatedID);

Parameters

hService

[in] Handle to a private SERVICE structure.

szFolderName

[in] Null-terminated string that contains the name of the folder to be created.

szParentID

[in] Null-terminated string that contains the identifier of the parent folder. If szParentID is NULL, this function creates the new folder in the root mail directory.

pszCreatedID

[in] Pointer—initialized by this function—to the null-terminated string that contains the identifier of the created folder.

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.

The client is responsible for calling the function TransportFreeFolderId to free storage allocated by this function.