odm_set_path Subroutine

Purpose

Sets the default path for locating object classes.

Library

Object Data Manager Library (libodm.a)

Syntax

#include <odmi.h>

char *odm_set_path ( NewPath)
char *NewPath;

Description

The odm_set_path subroutine is used to set the default path for locating object classes. The subroutine allocates memory, sets the default path, and returns the pointer to memory. Once the operation is complete, the calling application should free the pointer using the free (malloc, free, realloc, calloc, mallopt, mallinfo, mallinfo_heap, alloca, valloc, or posix_memalign Subroutine) subroutine.

Parameters

Item Description
NewPath Contains, as a string, the path name in the file system in which to locate object classes.

Return Values

Upon successful completion, a string pointing to the previous default path is returned. If the odm_set_path subroutine is unsuccessful, a value of -1 is returned and the odmerrno variable is set to an error code.

Error Codes

Failure of the odm_set_path subroutine sets the odmerrno variable to one of the following error codes:

See Object Data Manager (ODM) error codes in AIX® Version 7.1 Technical Reference: Base Operating System and Extensions, Volume 1 for explanations of the ODM error codes.