ITTAPI::RegisterCallNotifications

The RegisterCallNotifications method sets which new call notifications an application will receive. The application must call the method for each address, indicating media type or types it can handle, and specifying the privileges it requests.

An application that will make only outgoing calls does not need to call this method.

The ITTAPIEventNotification outgoing interface must be registered prior to calling this method.

If both owner and monitor privileges are needed for an address, this method should be called only once, with both fMonitor and fOwner set to TRUE.

HRESULT RegisterCallNotifications(
  ITAddress *pAddress,
  VARIANT_BOOL fMonitor,
  VARIANT_BOOL fOwner,
  long lMediaTypes,
  long lCallbackInstance,
  long *plRegister
);

Parameters

pAddress

[in] Pointer to ITAddress interface.

fMonitor

[in] Boolean value indicating whether the application will monitor calls. VARIANT_TRUE indicates that the application will monitor calls; VARIANT_FALSE that it will not.

fOwner

[in] Boolean value indicating whether the application will own incoming calls. VARIANT_TRUE indicates that the application will own incoming calls; VARIANT_FALSE indicates that it will not.

lMediaTypes

[in] Media types that can be handled by the application.

lCallbackInstance

[in] Callback instance to be used by the TAPI 3.0 DLL. Returned by IConnectionPoint::Advise during registration of the ITTAPIEventNotification outgoing interface.

plRegister

[out, retval] On success, returned value that is used by ITTAPI::UnregisterNotifications.

Return Values

Remarks

If multiple calls of this method are used on one address, the information about participant calls from a callhub may be confusing if a call that is already being monitored by the application is handed off to it.

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

ITTAPI, ITTAPIEventNotification, ITCallNotificationEvent, TAPI Object, Events overview