lineSetAppPriority-Funktion (tapi.h)

Artikel
03/02/2024

Die lineSetAppPriority-Funktion ermöglicht es einer Anwendung, ihre Priorität in der Übergabeprioritätsliste für einen bestimmten Medientyp oder den Modus für die anforderungsunterstützte Telefonie festzulegen oder sich selbst aus der Prioritätsliste zu entfernen.

Syntax

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

Parameter

lpszAppFilename

Ein Zeiger auf eine Zeichenfolge, die den Dateinamen des ausführbaren Moduls der Anwendung ohne die Verzeichnisdaten enthält. In TAPI Version 2.0 oder höher kann der Parameter einen Dateinamen im Format long oder 8.3 angeben.

dwMediaMode

Ein Medientyp, für den die Priorität der Anwendung festgelegt werden soll. Der Wert kann eine oder mehrere der LINEMEDIAMODE-Konstanten sein. Der Wert 0 sollte verwendet werden, um die Anwendungspriorität für Anforderungen der unterstützten Telefonie festzulegen.

lpExtensionID

Ein Zeiger auf eine Struktur vom Typ LINEEXTENSIONID. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

dwRequestMode

Die Bedingungen für diesen Parameter lauten: Wenn der dwMediaMode-Parameter null ist, gibt dieser Parameter den Anforderungsmodus für die unterstützte Telefonie an, für den die Priorität festgelegt werden soll. Es muss LINEREQUESTMODE_MAKECALL sein. Dieser Parameter wird ignoriert, wenn dwMediaMode ungleich null ist.

lpszExtensionName

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

dwPriority

Ein Parameter, der eine neue Priorität für die Anwendung angibt. Wenn der Wert 0 übergeben wird, wird die Anwendung aus der Prioritätsliste für die angegebenen Medien oder den angegebenen Anforderungsmodus entfernt. wenn es noch nicht vorhanden war, wird kein Fehler generiert. Wenn der Wert 1 übergeben wird, wird die Anwendung als Anwendung mit der höchsten Priorität für den Medien- oder Anforderungsmodus eingefügt. Sie wird von einer Position mit niedrigerer Priorität entfernt, wenn sie bereits in der Liste enthalten ist. Jeder andere Wert generiert einen Fehler.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.

Hinweise

Wenn LINEERR_INVALMEDIAMODE zurückgegeben wird, ist der in dwMediaMode angegebene Wert nicht null und keine der LINEMEDIAMODE_ Konstanten.

Diese Funktion aktualisiert die gespeicherte Prioritätsliste. Wenn das Telefonsystem initialisiert wird, legt es auch die aktuellen, aktiven Prioritäten für anwendungen fest, die dann ausgeführt werden. die neue Priorität wird für den nächsten eingehenden Anruf oder lineHandoff basierend auf dem Medientyp verwendet.

Die mit lineSetAppPriority festgelegten Prioritäten werden über Neustarts des Systems oder Neustarts von tapisrv hinweg beibehalten. Die LineOpen-Funktion öffnet die Zeile ohne angegebene Aufrufprioritäten. Standardmäßig ist die Anwendung mit der höchsten Priorität diejenige, die zuerst lineOpen aufgerufen hat.