ITTAPI::SetApplicationPriority-Methode (tapi3if.h)

Artikel
03/02/2024

Mit der SetApplicationPriority-Methode kann eine Anwendung ihre Priorität in der Übergabeprioritätsliste für einen bestimmten Medientyp oder den Anforderungsmodus für unterstützte Telefonie festlegen oder sich selbst aus der Prioritätsliste entfernen.

Syntax

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

Parameter

[in] pAppFilename

Zeiger auf BSTR , der den Namen der Anwendung enthält.

[in] lMediaType

Medien, die der Anwendung zugeordnet sind.

[in] fPriority

Die neue Priorität für die Anwendung. Wenn der Wert VARIANT_FALSE übergeben wird, wird die Anwendung aus der Prioritätsliste für den angegebenen Medien- oder Anforderungsmodus entfernt (wenn sie bereits nicht vorhanden war, wird kein Fehler generiert). Wenn der Wert VARIANT_TRUE übergeben wird, wird die Anwendung als Anwendung mit der höchsten Priorität für den Medien- oder Anforderungsmodus eingefügt (und aus einer Position mit niedrigerer Priorität entfernt, wenn sie bereits in der Liste enthalten war).

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pAppFilename-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.

Die prioritäten, die mit SetApplicationPriority festgelegt werden, bleiben bei Neustarts des Systems oder neustarts von tapisrv erhalten. Die Funktion ITTAPI::RegisterCallNotifications öffnet die Zeile ohne angegebene Aufrufprioritäten. Standardmäßig ist die Anwendung mit der höchsten Priorität diejenige, die zuerst ITTAPI::RegisterCallNotifications aufgerufen hat.