Metodo ITTAPI::SetApplicationPriority (tapi3if.h)
Il metodo SetApplicationPriority consente a un'applicazione di impostare la relativa priorità nell'elenco di priorità handoff per un tipo di supporto specifico o per la modalità richiesta di telefonia assistita oppure per rimuoverla dall'elenco di priorità.
Sintassi
HRESULT SetApplicationPriority(
[in] BSTR pAppFilename,
[in] long lMediaType,
[in] VARIANT_BOOL fPriority
);
Parametri
[in] pAppFilename
Puntatore a BSTR contenente il nome dell'applicazione.
[in] lMediaType
Supporti associati all'applicazione.
[in] fPriority
Nuova priorità per l'applicazione. Se il valore VARIANT_FALSE viene passato, l'applicazione viene rimossa dall'elenco di priorità per il supporto o la modalità richiesta specificata (se non è già presente, non viene generato alcun errore). Se il valore VARIANT_TRUE viene passato, l'applicazione viene inserita come applicazione con priorità più alta per il supporto o la modalità richiesta (e rimossa da una posizione con priorità inferiore, se è già presente nell'elenco).
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Memoria insufficiente per eseguire l'operazione. |
Commenti
L'applicazione deve usare SysAllocString per allocare memoria per il parametro pAppFilename e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.
Le priorità impostate con SetApplicationPriority verranno mantenute tra i riavvii del sistema o i riavvii di tapisrv. La funzione ITTAPI::RegisterCallNotifications apre la riga senza priorità di chiamata specificate. Per impostazione predefinita, l'applicazione con priorità più alta sarà quella denominata ITTAPI::RegisterCallNotifications.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (includere Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |