Table 2-5 describes the macros that an application can use to manipulate a capability bitmask:
Macro name |
Function |
---|---|
CS_TST_CAPMASK |
Test to see whether a specific capability is set to CS_TRUE or CS_FALSE |
CS_SET_CAPMASK |
Set a specific capability to CS_TRUE |
CS_CLR_CAPMASK |
Set a specific capability to CS_FALSE. |
When negotiating capabilities explicitly, rather than using the default settings, the following two rules apply:
CS_CAP_REQUEST Applications can only turn CS_CAP_REQUEST capabilities “off” from an “on” status.
If an application tries to turn a CS_CAP_REQUEST capability “off,” which is already in an “off” status, Open Server restores the default status and does not raise an error.
CS_CAP_RESPONSE Applications can only turn CS_CAP_RESPONSE capabilities “on” from an “off” status.
If an application tries to turn a CS_CAP_RESPONSE capability “on,” which is already in an “on” status, Open Server restores the default status and does not raise an error.