ADDRESS_CAPABILITY_STRING enumeration (tapi3if.h)

The ADDRESS_CAPABILITY_STRING enum is used to check on address capabilities which are described by strings.

Syntax

typedef enum ADDRESS_CAPABILITY_STRING {
  ACS_PROTOCOL = 0,
  ACS_ADDRESSDEVICESPECIFIC,
  ACS_LINEDEVICESPECIFIC,
  ACS_PROVIDERSPECIFIC,
  ACS_SWITCHSPECIFIC,
  ACS_PERMANENTDEVICEGUID
} ;

Constants

ACS_PROTOCOL Value: 0 Describes a protocol-specific capability. The value is returned as a GUID in string format. For possible values, see TAPIPROTOCOL_. A TSP may define additional values. Corresponds to the ProtocolGuid member of TAPI 2's LINEDEVCAPS structure.
ACS_ADDRESSDEVICESPECIFIC Describes an address device-specific capability. The value is TSP dependent and can be a structure, a string, or some other type. An application should use the BSTR pointer received from Tapi3.dll as a pointer to an array of bytes (a buffer), and then interpret the buffer according to TSP specifications. Corresponds to the dwDevSpecific and dwDevSpecificSize members of TAPI 2's LINEADDRESSCAPS structure.
ACS_LINEDEVICESPECIFIC Describes a line device-specific capability. The value is TSP dependent and can be a structure, a string, or some other type. An application should use the BSTR pointer received from Tapi3.dll as a pointer to an array of bytes (a buffer), and then interpret the buffer according to TSP specifications. Corresponds to the dwDevSpecific and dwDevSpecificSize members of TAPI 2's LINEDEVCAPS structure.
ACS_PROVIDERSPECIFIC Describes a provider-specific capability. The value is a plain string. It can be used with regular BSTR functions for operations such as printing and concatenating. A specific TSP might included embedded NULL characters inside these strings. If so, an application should take care when printing the value. If the embedded NULL characters are not replaced with blanks, the strings will appear truncated when printed. Corresponds to the dwProviderInfoSize and dwProviderInfoOffset members of TAPI 2's LINEDEVCAPS structure.
ACS_SWITCHSPECIFIC Describes a switch-specific capability. The value is a plain string. It can be used with regular BSTR functions for operations such as printing and concatenating. A specific TSP might included embedded NULL characters inside these strings. If so, an application should take care when printing the value. If the embedded NULL characters are not replaced with blanks, the strings will appear truncated when printed. Corresponds to the dwSwitchInfoSize and dwSwitchInfoOffset members of TAPI 2's LINEDEVCAPS structure.
ACS_PERMANENTDEVICEGUID Describes the GUID of a permanent device. The value is returned as a GUID in string format. This identifier must remain stable throughout, including operating system upgrades. Corresponds to the PermanentLineGuid member of TAPI 2's LINEDEVCAPS structure.

Requirements

Requirement	Value
Header	tapi3if.h

See also

Address object

ITAddress

ITAddressCapabilities::get_AddressCapabilityString

LINEADDRESSCAPS

LINEDEVCAPS

TAPIPROTOCOL_