Edit

ADDRESS_CAPABILITY_STRING enumeration (tapi3if.h)

  • Article

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_