ITCallInfo::get_CallInfoString method (tapi3if.h)

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

Syntax

HRESULT get_CallInfoString(
  [in]  CALLINFO_STRING CallInfoString,
  [out] BSTR            *ppCallInfoString
);

[in] CallInfoString

CALLINFO_STRING indicator of information type needed, such as CIS_DISPLAYABLEADDRESS.

[out] ppCallInfoString

Pointer to BSTR representation of needed string.

This method can return one of these values.

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

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