DioFileFindLabel

File.

Returns the specified label’s step number following the specified starting step.

DioFileFindLabel (hFile, dwStartStep, pdwStepLabel, pszLabel, pnStatus)

Name	Type	Comments
hFile	SHORT	File board handle returned by the function DioFileOpen.
dwStartStep	DWORD	Specified starting step to state looking for labels in the file.
pdwStepLabel	PDWORD	Returns the specified label’s step number following the specified starting step, if label was not found pdwStepLabel returns -1.
pszLabel	PSTR	Pointer to the string holding the label’s name.
pnStatus	PSHORT	Returned status: 0 on success, negative number on failure.

The following example returns the specified label’s step number following the specified starting step:

SHORT nStatus, hFile;

DWORD dwStepLabel;

DioFileOpen (szfilename, 1, &hFile, &nStatus);

if (hFile!=0 && nStatus==0)

DioFileFindLabel (hFile, 0, &dwStepLabel, “Clock”, &nStatus);