Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Getting Information About Call Appearances

TELGetCAFlags

Retrieves the current feature settings of a call appearance and updates the featureFlags and otherFeatures fields of its call appearance structure to reflect the current settings.

pascal TELErr TELGetCAFlags (
                     TELCAHandle hTELCA, 
                     long *caFeatureFlags, 
                     long *caOtherFeatures);

hTELCA

A handle to a call appearance structure whose feature settings you want to update.

caFeatureFlags

A pointer to your feature-flags variable. The function returns the current settings of the feature flags in your feature-flags variable and updates the structure's featureFlags field to reflect the current settings. See "Call Appearance Feature Flags" (page 4-15) for a description of the feature flags.

caOtherFeatures

A pointer to your other-features variable. The function returns the current settings of the other-feature flags in your other-feature variable and updates the structure's otherFeatures field to reflect the current settings. See "Other Call Appearance Feature Flags" (page 4-17) for a description of the other-feature flags.

function result

A result code. If you provide an invalid handle, the function returns the telBadCAErr result code.

DESCRIPTION

The TELGetCAFlags function returns, through the caFeatureFlags and caOtherFeatures parameters, the features of the call appearance specified by the hTELCA parameter. In addition, TELGetCAFlags updates the featureFlags and otherFeatures fields of the call appearance structure. The information in the updated structure reflects the state of the call appearance at the time the Telephone Manager retrieves the information from the telephone tool.

SEE ALSO

The TELGetCAInfo function (page 4-54) also updates the featureFlags and otherFeatures fields of a call appearance structure.