HP XP20000XP24000 Disk Array - Manual (Page 173)

Performing File Access Library (FAL) Operations 6-19
Hitachi USP V Cross-OS File Exchange User’s Guide
Information Storage Area
Format: memError= dataset_AllocGlobal(dgpp,derrno,malloc,free)
(Table 6-12)
Table 6-12 Arguments, Types and Descriptions for Information Storage
Area
Argument Type Description
dgpp
derrno
malloc
free
Return value: memError
0 void (see Note 2)
long (see Note 1)
void (see Note 2)
void (see Note 1)
int Global memory area
An error information stored area
malloc()
free()
Abnormal end
Note 1: When you issue this function, you must issue dataset_FreeGlobal()
in the end process.
Note 2: You must issue this function before dataset_Open() and
dataset_FindFirstFile().
• Arguments:
– dgpp: Global memory area stored area
– derrno: Return an address stored FAL error code
– malloc: Specify an address of malloc function. Specify as malloc.
– free: Specify an address of free function. Specify as free.
• Return Value:
– When this function ends normally, it returns a 1.
– When this function ends abnormally, it returns a 0. For further
information, refer to Appendix B.
• Example:
void *memptr; /* global memory area */
long err; /* global err information */
int retcode;
:
retcode = dataset_AllocGlobal(&memptr, &err, malloc, free);
:
retcode = dataset_FreeGlobal(&memptr, &err)