DioFileSetLabel

Applies To

File.

Purpose

Sets the specified step label.

Syntax

DioFileSetLabel (hFile, dwStep, pszLabel, pnStatus)

Parameters

Name
Type
Comments
hFile
SHORT
File board handle returned by the function DioFileOpen.
dwStep
DWORD
Sets label step.
pszLabel
PSTR
Pointer to the string holding the label’s name, limited to 512 characters.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Example

The following example sets a label at step 100:

 

SHORT nStatus, hFile;

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

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

DioFileSetLabel (hFile, 100, “Clock”, &nStatus);

 

See Also

DioFileGetLabel, DioFileFindLabel, DioGetErrorString