Re: [sca-c-cpp] NEW ISSUE: C API needs multiple value property retrieval

[Andrew Borley <BORLEY@uk.ibm.com>]

This issue has been assigned id CCPP-92
in the Jira system
See http://www.osoa.org/jira/browse/CCPP-92

Andrew

____________________________________________________________

Andrew Borley
Websphere ESB Development
Tel: 245393 Ext: +44 (0) 1962 815393 Mob: +44 (0) 7971 805547
E-mail: borley@uk.ibm.com
Mailpoint 211, IBM (UK) Ltd, Hursley Park, Winchester, Hants, SO21 2JN
____________________________________________________________

From:	Bryan Aupperle <aupperle@us.ibm.com>
To:	sca-c-cpp@lists.oasis-open.org
Date:	28/07/2009 21:39
Subject:	[sca-c-cpp] NEW ISSUE: C API needs multiple value property retrieval

---

Target: C C&I CD03 Rev 2 

Description: 
The current API definition only provides functions for retrieving single
property values.  However, it is possible to define a property that
can have multiple values.  It is possible to retrieve the multiple
values as an SDO, but SDO support is optional. There needs to be a way
to retrieve multiple values without using an SDO. 

Discussion: 
There are two options 
1) Duplicate the current SCAProperty<T>() functions as SCAPropertyIndex<T>
adding a index parameter to the new functions (all 15 of them).  The
new functions would retrieve the value at the specified index.

2) Add a SCAPropertyIndex(name, index, ...) which would set the index and
return an error if there is no value at the index.  A subsequent SCAProperty<T>()
call would return the value at the index. 

index - 0; 
SCAPropertyIndex(prop, index &cc, &reason);
while (reason != DATA_TRUNCATED) { 
   SCAPropertyCString(prop, &Value[i], size, &cc, &reason);
   index ++; 
   SCAPropertyIndex(prop, index, &cc, &reason);
} 

Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect

Research Triangle Park,  NC 
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com

---

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU