GetSuperFileNames

Retrieve superfile member name.

Short Name

GETMNAME()

Type

Low-level function

Declaration

COUNT GetSuperFileNames(COUNT filno, pTEXT nambuf,

                        VRLEN buflen, COUNT memberNo)

Description

GetSuperFileNames() retrieves the superfile member name for member number memberNo in superfile filno. After successful execution, the nambuf array, which is buflen bytes long, contains the superfile member name for member number memberNo.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful operation.
101	INOT_ERR	Member name not found.
411	BSUP_ERR	filno is not a superfile number.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

Example

#define buflen    64

TEXT nambuf[buflen];   /* superfile member name buffer */

COUNT ret=0;           /* function return           */

COUNT membno;          /* member # for loop control    */


/*list superfile member names for superfile number 5   */

for (membno =1; ret == 0; membno ++)

    if (ret=GetSuperFileNames(5,nambuf,buflen, membno))

        printf("\nError on GETMNAME, error = %d decimal",

               ret) ;

    else

        printf("\n%s is member #%d of superfile #5", nambuf, membno);