Name

omX_fill_oid - Initializes an OM_descriptor structure with an object identifier value

Synopsis

#include <xom.h>
#include <xomext.h> OM_return_code omX_fill_oid(
OM_type type,
OM_object_identifier object_id,
OM_descriptor ∗destination);

Parameters

Input

typeThe type of OM_descriptor structure. 

object_idThe object identifier value. 

Output

destinationContains the filled descriptor. 

Description

The omX_fill_oid() function is used to initialize an OM descriptor structure with user-supplied values for its type and value.  The syntax of the descriptor is always set to OM_S_OBJECT_IDENTIFIER_STRING. 

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