Brew MP 1.0.2
This function retrieves all of the data stored in a value model. The data may be very
simple or arbitrarily complex. In either case, the entire data store (or a pointer to
the data) is returned. The data returned by IValueModel_GetValue may be typed as
appropriate for the data being returned. For example, a model value that stores its
data as an integer would simply return the retrieved data as an int, whereas a more
complex model value -- say, one that stores seasonal statistics for major league baseball
players -- could return a pointer to a complex data structure (with fields containing at
bats, homeruns, hits, etc...).
Pointer to the IValueModel interface object.
Pointer into which the value model will store the length of the data being returned.
Pass NULL to indicate that the length of the data is not required (i.e. when the
value model is expected to return a data item that fits within the confines of a
void pointer -- a boolean, int, short, etc...).
void *IValueModel_GetValue(IValueModel *pif, int *pnLen);
The type of data returned by IValueModel_GetValue() is determined by the data defined in the
value model itself. For a simple value model in which the data may be stored in a data item
that fits in a void pointer, the return value is the data itself. For more complex value
models the return value may be a pointer to data -- or, NULL
, if the complex data could not