DioFileGroupDelete

Applies To

File.

Purpose

Delete the specified group’s name, and the group’s channels names string from the file.

Syntax

DioFileGroupDelete (hFile, pszGroupName, pnStatus)

Parameters

Name
Type
Comments
hFile
SHORT
Session identifier: File handle is used when communicating with a file. The File handle session identifier is returned by calling DioFileOpen.
pszGroupName
PCSTR
String specifying group name.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function delete the specified group’s name, and the group’s channels names string from the file. If the string specifying group name does not exists the function retunes an error.

Example

The following example deletes the group “Group1” and the group’s channels names string from the file:

 

SHORT hFile, nStatus;

DioFileGroupDelete (hFile, “Group1”, &nStatus);

 

See Also

DioFileOpen, DioFileClose, DioFileGroupGet , DioFileGroupGetChannelList , DioFileGroupGetName, DioFileGroupSet, DioGetErrorString