Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineSetAppPriority-Funktion ermöglicht es einer Anwendung, ihre Priorität in der Liste der Übergabeprioritäten für einen bestimmten Medientyp oder den Anforderungsmodus für die unterstützte Telefonie festzulegen oder sich aus der Prioritätsliste zu entfernen.
Syntax
LONG lineSetAppPriorityA(
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 enthält, ohne die Verzeichnisdaten. 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 Null sollte verwendet werden, um die Anwendungspriorität für Unterstützte Telefonieanforderungen festzulegen.
lpExtensionID
Ein Zeiger auf eine Struktur vom Typ LINEEXTENSIONID. Dieser Parameter wird ignoriert.
dwRequestMode
Die Bedingungen für diesen Parameter sind, 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 werden. Dieser Parameter wird ignoriert, wenn dwMediaMode- ungleich Null ist.
lpszExtensionName
Dieser Parameter wird ignoriert.
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 Anforderungsmodus entfernt. wenn sie 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 aus 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 auftritt, 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.
Bemerkungen
Wenn LINEERR_INVALMEDIAMODE zurückgegeben wird, ist der in dwMediaMode- angegebene Wert nicht 0 und keine der LINEMEDIAMODE_ Konstanten.
Diese Funktion aktualisiert die Liste der gespeicherten Priorität. Wenn das Telefoniesystem 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 beibehalten. Die lineOpen-Funktion öffnet die Zeile ohne angegebene Aufrufprioritäten. Standardmäßig ist die Anwendung mit der höchsten Priorität die erste, die lineOpenaufgerufen wird.
Anmerkung
Der header tapi.h definiert lineSetAppPriority als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |