Hitachi MK-96RD647-01 manual Datsethandle, Dataset handler

Table 6-21 Arguments, Types and Descriptions for Get Multiple Dataset Attribute Information (2)

Argument	Type	Description
global	void (see Note 1)	Global memory area
g_error	long (see Note 1)	An error information stored area
datasetHandle ffd	DATSET_HANDLE	Dataset handler
Return value: datasetError	DATASET_FIND_DATA	A dataset attribute information stored area
-1	long	Abnormal end

This function gets a second dataset and more attribute information. You can get just the next set of dataset attribute information, or you can use this function until no further dataset information is available or returned.

•Argument (2):

–global: Global memory area (Specify a Global memory area gotten by dataset_AllocGlobal.).

–g_error: Specify an address to store FAL error code.

–datasetHandle: Specify dataset handler.

–ffd: Next dataset attribute information stored area.

Refer to dataset_GetFileInformation for dataset attribute information.

•Return Value (2):

–When this function ends normally, “0” is returned.

–When this function ends abnormally, “- 1” is returned.

–When “- 1” is returned, refer to the contents of g_error and for error code details. For further information, see Appendix B.

–When there is no dataset in the VTOC, the return value is “- 1” and error information is DATASET_ERROR_END_OF_VTOC.

Note*: You must issue dataset_FindFirstFile before this function. When you finish getting dataset attribute information, you must issue dataset_FindClose in the end process.

•Format (3): datasetError= dataset_FindClose(global,g_error,datasetHandle).

Table 6-22 Arguments, Types and Descriptions for Get Multiple Dataset Attribute Information (3)

Argument

Type

Description

Performing File Access Library (FAL) Operations 6-29

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