PEXSetStructurePermission - Set Structure Permission (5.2)

Synopsis

 
   void PEXSetStructurePermission(
        Display *display,
        PEXStructure structure,
        int permission
   )
 

Arguments

display

A pointer to a display structure returned by a successful XOpenDisplay call.

structure

The resource identifier of the structure.

permission

The structure permission (PEXStructureWriteOnly or PEXStructureLocked).

Returns

None.

Description

Invoke PEXSetStructurePermission to set the permission of the specified structure.

PEXlib defines the following values for structure permission:

PEXStructureWriteOnly -

indicates you can write elements to the structure (but you cannot copy its elements to a structure which has a permission of PEXStructureLocked.

PEXStructureLocked -

indicates you cannot edit, inquire, or copy elements from the structure.

For more information, see Structure Permissions.

Errors

BadPEXStructure

The specified structure resource identifier is invalid.

BadPEXStructurePermission

The specified structure permission is invalid. Changing Structure Permissions.

BadValue

The value in permission is invalid.

See Also

For a list of all Structure functions and related topics, see Structures.