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

type: The type of OM_descriptor structure.
object_id: The object identifier value.

Output

destination: Contains 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

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.