Platform SDK: TAPI

ITBasicCallControl::Pickup

Picks up a call alerting at the specified group identification.

HRESULT Pickup(
  BSTR pGroupID
);

Parameters

pGroupID: [in] Pointer to a BSTR containing the group identifier to which the alerting station belongs.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_FAIL	Pickup did not succeed.
E_POINTER	The pGroupID parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
TAPI_E_TIMEOUT	The operation failed because the TAPI 3.0 DLL timed it out. The timeout interval is two minutes.

Remarks

The application must use SysAllocString to allocate memory for the pGroupID parameter and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

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

ITBasicCallControl::Pickup

Parameters

Return Values

Remarks

Requirements

See Also