IMailSyncHandler::SetFolderOptions

  • Article

4/8/2010

The SetFolderOptions method is used by Messaging to request that the transport set various folder options on a folder.

Syntax

HRESULT SetFolderOptions (
  IMAPIFolder * pfldr,
  FOLDERNODE * pnode,
  FOLDEROPTIONS opts,
  LPSPropValue pval
);

Parameters

  • pfldr
    [in] Reference to an IMAPIFolder object corresponding to the folder.
  • pnode
    [in] Reference to a FOLDERNODE object corresponding to the folder.
  • opts
    [in] Folder option to set, specified by the FOLDEROPTIONS enumeration.
  • pval
    [in] Reference to a SPropValue structure that contains the new value for the folder option. There is no need to free this buffer or hold onto it. It is valid only for the duration of the call.

Return Value

  • S_OK
    Indicates success.

Remarks

Values in FOLDEROPTIONS that start with koptQuery or koptGet retrieve the value for the corresponding option instead of setting it.

Requirements

Header cemapi.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMailSyncHandler
IMailSyncHandler::FOLDEROPTIONS

Other Resources

Messaging