ITCallInfo::put_CallInfoString method (tapi3if.h)

The put_CallInfoString method sets call information items described by a string, such as the displayable address.

Syntax

HRESULT put_CallInfoString(
  [in] CALLINFO_STRING CallInfoString,
  [in] BSTR            pCallInfoString
);

Parameters

[in] CallInfoString

CALLINFO_STRING indicator of information type, such as CIS_DISPLAYABLEADDRESS.

[in] pCallInfoString

Pointer to a BSTR representation of the string.

Return value

This method can return one of these values.

Value Meaning
S_OK
Method succeeded.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
E_INVALIDARG
The CallInfoString parameter is not a valid value.
TAPI_E_INVALCALLSTATE
The current call state is not valid for this operation.

Remarks

The application must use SysAllocString to allocate memory for the string data referenced by pCallInfoString parameter and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

CALLINFO_STRING

Call Object

ITCallInfo

get_CallInfoString