Platform SDK: TAPI

ITCallInfo::get_CallInfoString

Gets call information items described by a string, such as the displayable address.

HRESULT get_CallInfoString(
  CALLINFO_STRING CallInfoString,
  BSTR *ppCallInfoString 
);

Parameters

CallInfoString
[in] CALLINFO_STRING indicator of information type needed, such as CIS_DISPLAYABLEADDRESS.
ppCallInfoString
[out] Pointer to BSTR representation of needed string.

Return 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 Call state must not be CS_IDLE.

Remarks

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

Requirements

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

See Also

ITCallInfo, Call Object, put_CallInfoString, CALLINFO_STRING