Platform SDK: TAPI

ITAddressCapabilities::get_AddressCapabilityString

Gets the capability string for a given ADDRESS_CAPABILITY_STRING.

HRESULT get_AddressCapabilityString(
  ADDRESS_CAPABILITY_STRING AddressCapString,
  BSTR *ppCapabilityString
);

Parameters

AddressCapString: [in] Descriptor for desired address capability string.
ppCapabilityString: [out, retval] Pointer to BSTR value of address capability. NULL is a possible return value if the TSP does not provide a value for AddressCapString.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_INVALIDARG	The AddressCapString parameter is not valid.
E_POINTER	The ppCapabilityString parameter is not a valid pointer.
TAPI_E_NOTSUPPORTED	TAPI version is not 3.0 or higher.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

The application must use SysFreeString to free the memory allocated for the ppCapabilityString parameter.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

ITAddressCapabilities::get_AddressCapabilityString

Parameters

Return Values

Remarks

Requirements

See Also