NAME

SYNOPSIS

#include <xom.h>
#include <xomext.h>

OM_return_code omX_object_to_string(
        OM_object object,
        OM_boolean local_strings,
        OM_string *string);

PARAMETERS

Input

object

Contains the OM object to be converted.

local_strings

This Boolean value indicates if the string return value should be converted to a local string format. For further information on local strings please refer to Chapter 10 in the Directory Services part of the OSF DCE Application Development Guide.

Output

string

Contains the converted object in string format.

The calling function should provide the memory for string. The string's contents are initially unspecified. The string's length becomes the number of octets required to contain the segment that the function is to read. The service modifies this parameter. The string's elements become the elements actually read. The string's length becomes the number of octets required to hold the segment actually read.

DESCRIPTION

The omX_object_to_string() function converts an OM object into a string format. The object can either be a client-generated or a service-generated public or private object.

The objects that can be handled by this function are restricted to those defined in the schema file, xoischema. Additionally, the OM objects DS_C_ATTRIBUTE_ERROR and DS_C_ERROR are also handled. For these, a message string containing the error message is returned.

For the syntax of the output strings please refer to Chapter 9 in the OSF DCE Application Development Guide.

RETURN VALUES

OM_return_code

Indicates whether the function succeeded and, if not, why not. If the function is successful, the value of OM_return_code is set to OM_SUCCESS; if the function fails, it has one of the error values listed in the xom.h(4xom) reference page.

ERRORS

Refer to xom.h(4xom) and xomext.h for a list of the possible error values that can be returned in OM_return_code.