Send Feedback

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


HRESULT SetFolderOptions (
  IMAPIFolder * pfldr,
  FOLDERNODE * pnode,
  LPSPropValue pval


  • 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 Values

  • S_OK
    Indicates success.


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


Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: cemapi.h
Library: cemapi.lib

See Also

IMailSyncHandler | FOLDEROPTIONS | Messaging

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.