Edit

Share via

ITCallInfo::get_CallInfoString method (tapi3if.h)

  • Article

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
);

Parameters

[in] CallInfoString

CALLINFO_STRING indicator of information type needed, such as CIS_DISPLAYABLEADDRESS.

[out] ppCallInfoString

Pointer to BSTR representation of needed 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_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.

Remarks

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

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

put_CallInfoString