ITCallInfo::get_CallInfoBuffer method (tapi3if.h)

The get_CallInfoBuffer method gets call information items which require a buffer, such as user-user information. This method is provided for Automation client applications, such as those written in Visual Basic. C and C++ applications must use the ITCallInfo::GetCallInfoBuffer method.

Syntax

HRESULT get_CallInfoBuffer(
  [in]  CALLINFO_BUFFER CallInfoBuffer,
  [out] VARIANT         *ppCallInfoBuffer
);

Parameters

[in] CallInfoBuffer

CALLINFO_BUFFER indicator of information type needed, such as CIB_USERUSERINFO.

[out] ppCallInfoBuffer

Pointer to VARIANT representation of call information buffer. The application must call the CoTaskMemFree function to free the memory allocated for this parameter.

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 ppCallInfoBuffer parameter is not a valid pointer.
E_INVALIDARG
The CallInfoBuffer parameter is not a valid value.
TAPI_E_INVALCALLSTATE
The current call state is not valid for this operation.

Requirements

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

See also

CALLINFO_BUFFER

Call Object

GetCallInfoBuffer

ITCallInfo

SetCallInfoBuffer

put_CallInfoBuffer