Name

omX_fill - Initializes an OM_descriptor structure

Synopsis

#include <xom.h>
#include <xomext.h> OM_return_code omX_fill(
OM_type type,
OM_syntax syntax,
OM_uint32 length,
void ∗elements,
OM_descriptor ∗destination);

Parameters

Input

typeThe type of OM descriptor structure. 

syntaxThe syntax value for this OM descriptor. 

lengthThe data length for values of string syntax.  Zero is entered for values of type OM_object.  When initializing an OM_descriptor with an OM_type that has an OM_syntax of either OM_­S_­INTEGER, OM_­S_­BOOLEAN or OM_­S_­ENUMERATION, then the associated value must be entered in the length parameter. 

elementsThe string contents. 

Output

destinationContains the filled descriptor. 

Description

The omX_fill() function is used to initialize an OM descriptor structure with user supplied values for its type, syntax, and value. 

Return Values

The following describes a partial list of messages (or errors) that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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 the OSF DCE Problem Determination Guide for complete descriptions of all error messages.  Refer to xom.h(4xom) for a list of the possible error values that can be returned in OM_return_code.