sub-rotina odm_add_obj
Propósito
Inclui um novo objeto em uma classe de objeto.
Biblioteca
Biblioteca do Object Data Manager (libodm.a)
Sintaxe
#include <odmi.h>
int odm_add_obj ( ClassSymbol, DataStructure)
CLASS_SYMBOL ClassSymbol;
struct ClassName *DataStructure;Descrição
A sub-rotina odm_add_obj usa como entrada o símbolo de classe que identifica a classe de objeto a ser incluída e um ponteiro para a estrutura de dados que contém o objeto a ser incluído.
A sub-rotina odm_add_obj é aberta e fecha a classe de objeto em torno da sub-rotina se a classe de objeto não foi aberta anteriormente. Se a classe de objeto foi previamente aberta, a subroutine deixa a classe de objeto aberta quando ela retornar.
Parâmetros
| Item | Descrição |
|---|---|
| ClassSymbol | Especifica um identificador de símbolo de classe retornado de uma sub-rotina odm_open_class . Se a sub-rotina odm_open_class não tiver sido chamada, esse identificador será a estrutura ClassName_CLASS criada pelo comando odmcreate . |
| DataStructure | Especifica um ponteiro para uma instância da estrutura de linguagem C correspondente à classe de objeto referida pelo parâmetro ClassSymbol . A estrutura é declarada no arquivo .h criado pelo comando odmcreate e tem o mesmo nome que a classe de objetos |
Valores De Retorno
Após a conclusão bem-sucedida, um identificador para o objeto que foi adicionado é retornado. Se a sub-rotina ' odm_add_obj não for bem-sucedida, um valor de -1 será retornado e a variável ' odmerrno será definida com um código de erro.
Códigos De Erro
Falha da sub-rotina odm_add_obj configura a variável odmerrno para um dos seguintes códigos de erro:
- ODMI_CLASS_DNE
- ODMI_CLASS_PERMS
- ODMI_INVALID_CLXN
- ODMI_INVALID_PATH
- ODMI_MAGICNO_ERR
- ODMI_OPEN_ERR
- ODMI_PARAMS
- ODMI_READ_ONLY
- ODMI_TOOMANYCLASSES
Consulte Códigos de erro do Object Data Manager (ODM) para obter explicações dos códigos de erro ODM .