ART_group_access

This function sets the access control (editable or view only) for all of the marks in the group specified by szGroupName.

Declaration:

	Copy Code
AT_ERRCOUNT ART_group_access( HIGEAR hIGear, const LPSTR szGroupName, BOOL fEnable );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle to the image.
szGroupName	const LPSTR	A far pointer to a null-terminated string that tells ART which group of marks' access to change.
fEnable	BOOL	A flag of type BOOL that tells ART whether to allow editing for all the marks in the group specified by szGroupName.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / char FAR szGroupName; /* type of group to make / / accessible / / Deny access to the MIS Group */ szGroupName = "MIS Group"; nErrcount = ART_group_access(hIGear,szGroupName,FALSE);

Copy Code

HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szGroupName; /* type of group to make  */
/* accessible  */
/* Deny access to the MIS Group */
szGroupName = "MIS Group";
nErrcount = ART_group_access(hIGear,szGroupName,FALSE);

Remarks:

When fEnable is set to TRUE, the end user can edit or modify marks in the group; when set to FALSE the end user cannot edit or modify marks in the group.

An error is set if any of the following conditions are met:

hIGear does not reference a valid ImageGear handle.
szGroupName does not point to a valid address.
No group matches szGroupName.