ITCallInfo::GetCallInfoBuffer method (tapi3if.h)

The GetCallInfoBuffer method 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.

Syntax

HRESULT GetCallInfoBuffer(
  [in]  CALLINFO_BUFFER CallInfoBuffer,
  [out] DWORD           *pdwSize,
  [out] BYTE            **ppCallInfoBuffer
);

Parameters

[in] CallInfoBuffer

CALLINFO_BUFFER indicator of information type needed, such as CIB_USERUSERINFO.

[out] pdwSize

Size of buffer returned in bytes.

[out] ppCallInfoBuffer

Pointer to buffer containing the needed call information.

Return value

This method can return one of these values.

Return code Description
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
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

ITCallInfo

SetCallInfoBuffer

get_CallInfoBuffer

put_CallInfoBuffer