Hitachi MK-96RD647-01 manual Information Storage Area, Argument Type Description

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	void (see Note 2)	Global memory area
derrno	long (see Note 1)	An error information stored area
malloc	void (see Note 2)	malloc()
free	void (see Note 1)	free()
Return value: memError	int	Abnormal end
0

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)

Performing File Access Library (FAL) Operations 6-19

Hitachi USP V Cross-OS File Exchange User’s Guide