CORBA API

CORBA Programming Reference

CORBA::Context::get_values

Synopsis

Retrieves the values for a given attribute in the Context object within the specified scope.

C++ Binding

void CORBA::Context::get_values (
      const char *             StartScope,
      CORBA::Flags             OpFlags,
      const char *             AttrName,
      CORBA::NVList_out        AttrValues);

Arguments

StartScope

The Context object level at which to initiate the search for specified properties. The level is the name of the context, or parent, at which the search is started. If the value is 0 (zero), the search begins with the current Context object.

OpFlags

The only valid operation flag is CORBA::CTX_RESTRICT_SCOPE. If you specify this flag, the object implementation restricts the property search to the current scope only (that is, the property search is not executed recursively up the chain of the parent context); otherwise, the search continues to a wider scope until a match has been found or until all wider levels have been searched.

AttrName

The name of the attribute whose values are to be returned. If this argument has a trailing wildcard character (*), all names that match the string preceding the wildcard character are returned.

AttrValues

Receives the values for the specified attributes (returns an NVList object) where each item in the list is a NamedValue.

Exceptions

CORBA::BAD_PARAM if attribute is an empty string.
CORBA::BAD_CONTEXT if no matching attributes were found.
CORBA::NO_MEMORY if dynamic memory allocation failed.

Description

This member function retrieves the values for a specified attribute in the Context object. These values are returned as an NVList object, which must be freed when no longer needed using the CORBA::release member function.

Return Values

None.