ITTAPI::SetApplicationPriority-Methode (tapi3if.h)
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 |
|---|---|
|
Methode war erfolgreich. |
|
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |