Share via

Fields Property

  • Article

Fields Property

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The property collection for the ProcessInstance object that initiated the WorkflowSession. This property is read-only.

Syntax



[Visual Basic]Property Fields As ADODB.Fields






[C++]HRESULT get_Fields(Fields** varFields);


Parameters




    

  • varFields
    
Returned reference to the Fields collection of the object.
    • 





Remarks




This property is read-only in that you cannot get a Fields collection from a different item, but you can modify fields in this collection. The collection you get from the WorkflowSession object is read/write.


The WorkflowSession Fields collection maps directly to the ProcessInstance Fields collection. Use this collection to put and get properties for the ProcessInstance that initiated the session.


You cannot use the WorkflowSession Fields collection to modify ProcessInstance schema properties including the following. The workflow engine maintains strict control over these properties.


    

  • "https://schemas.microsoft.com/cdo/workflow/currentstate"
    • 

  • "https://schemas.microsoft.com/cdo/workflow/expirytime"
    • 

  • "https://schemas.microsoft.com/cdo/workflow/processdefinition"
    • 

  • "https://schemas.microsoft.com/cdo/workflow/trackingtablexml"
    • 



Note  When you use the Microsoft ActiveX Data Objects (ADO) Fields.Update method, field values are updated only in memory. You must call the Save Method to save the changes to the Exchange store. To get the IDataSource interface, use the GetInterface method on the Collaboration Data Objects (CDO) object.




Example




You can use the WorkflowSession Fields collection in an assignment for only your custom properties. The following works, for example:




...
workflowsession.Fields("YourNameSpace://workflow/yourcustomproperty") = "yourPropValue"



See Also




Fields Property




Send us your feedback about the Microsoft Exchange Server 2003 SDK.


Build: June 2007 (2007.618.1)


© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.