HP XP20000XP24000 Disk Array - Manual (Page 183)

Performing File Access Library (FAL) Operations 6-29
Hitachi USP V Cross-OS File Exchange User’s Guide
Table 6-21 Arguments, Types and Descriptions for Get Multiple Dataset
Attribute Information (2)
Argument Type Description
global
g_error
datasetHandle ffd
Return value: datasetError
-1
void (see Note 1)
long (see Note 1)
DATSET_HANDLE
DATASET_FIND_DATA
long
Global memory area
An error information stored area
Dataset handler
A dataset attribute information stored area
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