2-32
SOMobjects Base Toolkit: Programmer’s Reference Manual
get_values Method
Purpose
Retrieves the specified property values.
IDL Syntax
ORBStatus get_values (
in Identifier start_scope,
in Flags op_flags,
in Identifier prop_name,
out NVList values);
Description
The get_values method retrieves the specified Context property values(s). If prop_name
has a trailing wildcard character(“*”), then all matching properties and their values are
returned. OWNERSHIP of the returned NVList object is transferred to the caller.
If no properties are found, an error is returned and no property list is returned.
Scope indicates the level at which to initiate the search for the specified properties. If a
property is not found at the indicated level, the search continues up the Context object tree
until a match is found or all Context objects in the chain have been exhausted.
If scope name is omitted, the search begins with the specified Context object. If the
specified scope name is not found, an exception is returned.
Parameters
receiver A pointer to the Context object from which the properties are to be
retrieved.
env A pointer to the Environment structure for the method caller.
start_scope An Identifier specifying the name of the Context object at which search for
the properties should commence.
op_flags A bitmask (long). The operation flag CTX_RESTRICT_SCOPE may be
specified. Searching is limited to the specified search scope or Context
object.
prop_name An Identifier specifying the name of the property value(s) to return.
values The address to store a pointer to the resulting NVList object.
Return Value
The get_values method returns an ORBStatus value representing the return code from the
operation.
Kommentare zu diesen Handbüchern