GetItemValues Method (ISecureContextData)

Enables a participant in a common context session to obtain the values of common and secure subject the items in the common context.

Syntax

C#
Visual Basic
Objective-C
Java
C++

object GetItemValues( 
   int participantCoupon,
   string[] itemNames,
   bool onlyChanges,
   int contextCoupon,
   string appSignature,
   out string managerSignature
)

'Declaration

Function GetItemValues( _
   ByVal participantCoupon As Integer, _
   ByVal itemNames() As String, _
   ByVal onlyChanges As Boolean, _
   ByVal contextCoupon As Integer, _
   ByVal appSignature As String, _
   ByRef managerSignature As String _
) As Object

'Usage

Dim instance As ISecureContextData
Dim participantCoupon As Integer
Dim itemNames() As String
Dim onlyChanges As Boolean
Dim contextCoupon As Integer
Dim appSignature As String
Dim managerSignature As String
Dim value As Object
 
value = instance.GetItemValues(participantCoupon, itemNames, onlyChanges, contextCoupon, appSignature, managerSignature)

Object^ GetItemValues( 
   int participantCoupon,
   array<String^>^ itemNames,
   bool onlyChanges,
   int contextCoupon,
   String^ appSignature,
   [Out] String^ managerSignature
)

Parameters

participantCoupon: The participant coupon of the application received from JoinCommonContext.
itemNames: The name of the context item values to get.
onlyChanges: Enables a participant to instruct the context manager to filter which items it returns no matter what names were specified. When the value of onlyChanges is true, then the items that are returned are limited to only the context subjects whose items were set by the most recently committed context change transaction, or by the transaction in progress, as indicated by the value of contextCoupon.
contextCoupon: The context coupon.
appSignature: The applications digital signature.
managerSignature: The manager's digital signature.

Return Value

A string array containing the common subject context item values.

Remarks

When the value of the input contextCoupon denotes the most recently committed transaction, the item values that are returned represent the state of the common context as it existed when the transaction was completed. When the value of the input contextCoupon denotes the transaction currently in progress, the item values that are returned represent the state of the common context as it has been established so far by the transaction

Requirements

Target Platforms

Reference

ISecureContextData Interface
ISecureContextData Members