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 Error Codes for a complete listing of valid c-tree 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);
}