ITTAPI::RegisterCallNotifications-Methode (tapi3if.h)

Artikel
08/26/2023

Die RegisterCallNotifications-Methode legt fest, welche neuen Aufrufbenachrichtigungen eine Anwendung empfängt. Die Anwendung muss die -Methode für jede Adresse aufrufen, den Medientyp oder die typen angeben, die sie verarbeiten kann, und die berechtigungen angeben, die sie anfordert.

Eine Anwendung, die nur ausgehende Aufrufe durchführt, muss diese Methode nicht aufrufen.

Die ausgehende ITTAPIEventNotification-Schnittstelle muss vor dem Aufrufen dieser Methode registriert werden.

Wenn sowohl Besitzer- als auch Überwachungsberechtigungen für eine Adresse erforderlich sind, sollte diese Methode nur einmal aufgerufen werden, wobei sowohl fMonitor als auch fOwner auf TRUE festgelegt sind.

Syntax

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

Parameter

[in] pAddress

Zeiger auf die ITAddress-Schnittstelle .

[in] fMonitor

Boolescher Wert, der angibt, ob die Anwendung Aufrufe überwacht. VARIANT_TRUE gibt an, dass die Anwendung Aufrufe überwacht; VARIANT_FALSE, dass dies nicht geschieht.

[in] fOwner

Boolescher Wert, der angibt, ob die Anwendung eingehende Anrufe besitzt. VARIANT_TRUE gibt an, dass die Anwendung eingehende Anrufe besitzt. VARIANT_FALSE gibt an, dass dies nicht der Wert ist.

[in] lMediaTypes

Medientypen , die von der Anwendung verarbeitet werden können.

[in] lCallbackInstance

Rückruf instance, die von der TAPI 3-DLL verwendet werden soll. Dies kann der gulAdvise-Wert sein, der von IConnectionPoint::Advise während der Registrierung der ausgehenden ITTAPIEventNotification-Schnittstelle zurückgegeben wird.

[out] plRegister

Bei Erfolg der zurückgegebene Wert, der von ITTAPI::UnregisterNotifications verwendet wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Der parameter plRegister ist kein gültiger Zeiger.
TAPI_E_NOT_INITIALIZED	Das TAPI-Objekt wurde nicht initialisiert.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

Wenn mehrere Aufrufe dieser Methode für eine Adresse verwendet werden, können die Informationen über Teilnehmeraufrufe von einem Anrufhub verwirrend sein, wenn ein Aufruf, der bereits von der Anwendung überwacht wird, an diesen übergeben wird.

Die RegisterCallNotifications-Methode registriert die Anwendung als interesse an der Überwachung von Aufrufen oder dem Empfang des Besitzes von Aufrufen der angegebenen Medientypen. Diese Aufrufberechtigungen werden in den Parametern fMonitor und fOwner festgelegt. Eine Anwendung kann mehrere Flags angeben, um mehrere Medientypen zu verarbeiten. Konflikte können auftreten, wenn sich mehrere Anwendungen für denselben Adress- und Medientyp registrieren. Diese Konflikte werden durch ein Prioritätsschema gelöst, bei dem der Benutzer den Anwendungen relative Prioritäten zuweist. Benutzer können Anwendungsprioritäten festlegen, indem sie die Funktion ITTAPI::SetApplicationPriority aufrufen. Nur die Anwendung mit der höchsten Priorität für einen bestimmten Medientyp erhält (nicht angefordert) den Besitz eines Aufrufs dieses Medientyps. Der Besitz kann empfangen werden, wenn ein eingehender Anruf zum ersten Mal eingeht oder wenn ein Anruf übergeben wird. Die Funktionen ITBasicCallControl::HandoffDirect und ITBasicCallControl::HandoffIndirect werden aufgerufen, um den Besitz eines Aufrufs an eine andere Anwendung zu übergeben. Wenn der Benutzer der Anwendung keine Prioritäten zuweist und mehrere Anwendungen dasselbe Leitungsgerät öffnen, hat die Anwendung, die zuerst RegisterCallNotifications aufgerufen hat, die höchste Priorität.