Platform SDK: TAPI

ITCallInfo::GetCallInfoBuffer

Gets call information items that require a buffer, such as user-user information. Automation client applications, such as those written in Visual Basic, must use the ITCallInfo::get_CallInfoBuffer method.

HRESULT GetCallInfoBuffer(
  CALLINFO_BUFFER CallInfoBuffer,
  DWORD * pdwSize,
  BYTE ** ppCallInfoBuffer 
);

Parameters

CallInfoBuffer
[in] CALLINFO_BUFFER indicator of information type needed, such as CIB_USERUSERINFO.
pdwSize
[out] Size of buffer returned in bytes.
ppCallInfoBuffer
[out] Pointer to buffer containing the needed call information.

Return Values

Value Meaning
S_OK Method succeeded.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.
E_POINTER The pdwSize or ppCallInfoBuffer parameter is not a valid pointer.
E_INVALIDARG The CallInfoBuffer parameter is not a valid value.
TAPI_E_INVALCALLSTATE Call state must not be CS_IDLE.

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, SetCallInfoBuffer, get_CallInfoBuffer, put_CallInfoBuffer, CALLINFO_BUFFER