Subrutina odm_mount_class

Finalidad

Recupera la estructura de símbolos de clase para el nombre de clase de objeto especificado.

Biblioteca

Biblioteca del gestor de datos de objetoslibodm.a)

Sintaxis

#include <odmi.h>

Descripción

La subrutina odm_mount_class recupera la estructura de símbolos de clase para una clase de objeto especificada. La subrutina puede ser invocada por aplicaciones (por ejemplo, los mandatos ODM ) que no tienen conocimientos previos de la estructura de una clase de objeto antes de intentar acceder a dicha clase. La subrutina odm_mount_class determina la descripción de la clase a partir de la información de la cabecera de la clase de objeto y crea una clase de objeto CLASS_SYMBOL que se devuelve a la persona que llama.

La subrutina odm_mount_class no abre la clase de objeto. Si se llama a la subrutina varias veces para una clase de objeto que ya está abierta o montada, se devuelve la misma clase de objeto CLASS_SYMBOL.

Montaje de una clase que enlaza con otra clase de objeto de forma recursiva a la clase enlazada. Sin embargo, si el montaje recursivo no tiene éxito, la subrutina odm_mount_class original no falla; la clase de objeto CLASS_SYMBOL se establece con un enlace nulo.

Parámetros

Valores de retorno

Tras la finalización satisfactoria, se devuelve un CLASS_SYMBOL . Si la subrutina odm_mount_class no tiene éxito, se devuelve un valor de -1 y la variable odmerrno se establece en un código de error.

Códigos de error

El fallo de la subrutina odm_mount_class establece la variable odmerrno a uno de los siguientes códigos de error:

• ODMI_BAD_CLASSNAME
• ODMI_BAD_CLXNNAME
• ODMI_CLASS_DNE
• ODMI_CLASS_PERMS
• ODMI_CLXNMAGICNO_ERR
• ODMI_INVALID_CLASS
• ODMI_INVALID_CLXN
• ODMI_MAGICNO_ERR
• ODMI_MALLOC_ERR
• ODMI_OPEN_ERR
• ODMI_PARAMS
• ODMI_TOOMANYCLASSES
• ODMI_TOOMANYCLASSES

Consulte ../bostechref/odm_error_codes.html para obtener explicaciones sobre los códigos de error ODM.