Gateway applications often need to set or retrieve all capabilities of a type category with a single call to ct_capability. To do this, an application calls ct_capability with:
type as the type category of interest
capability as CS_ALL_CAPS
value as a CS_CAP_TYPE structure
Client-Library provides the following macros to enable an application to set, clear, and test bits in a CS_CAP_TYPE structure:
CS_CLR_CAPMASK(mask, capability) – modifies the CS_CAP_TYPE structure mask by clearing the bits specified in capability.
CS_SET_CAPMASK(mask, capability) – modifies the CS_CAP_TYPE structure mask by setting the bits specified in capability.
CS_TST_CAPMASK(mask, capability) – determines whether the CS_CAP_TYPE mask includes the bits specified in capability.