Funzione lineSetAppPriority (tapi.h)

Articolo
03/02/2024

La funzione lineSetAppPriority consente a un'applicazione di impostare la priorità nell'elenco di priorità di handoff per un particolare tipo di supporto o modalità richiesta di telefonia assistita oppure per rimuoverla dall'elenco di priorità.

Sintassi

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

Parametri

lpszAppFilename

Puntatore a una stringa contenente il nome file del modulo eseguibile dell'applicazione, senza i dati della directory. In TAPI versione 2.0 o successiva, il parametro può specificare un nome file in formato di nome file long o 8.3.

dwMediaMode

Tipo di supporto per il quale deve essere impostata la priorità dell'applicazione. Il valore può essere una o più costanti LINEMEDIAMODE . Il valore zero deve essere usato per impostare la priorità dell'applicazione per le richieste di telefonia assistita.

lpExtensionID

Puntatore a una struttura di tipo LINEEXTENSIONID. Questo parametro viene ignorato.

dwRequestMode

Le condizioni per questo parametro sono, se il parametro dwMediaMode è zero, questo parametro specifica la modalità richiesta di telefonia assistita per la quale deve essere impostata la priorità. Deve essere LINEREQUESTMODE_MAKECALL. Questo parametro viene ignorato se dwMediaMode è diverso da zero.

lpszExtensionName

Questo parametro viene ignorato.

dwPriority

Parametro che indica una nuova priorità per l'applicazione. Se il valore 0 viene passato, l'applicazione viene rimossa dall'elenco di priorità per il supporto o la modalità richiesta specificati; se non è già presente, non viene generato alcun errore. Se il valore 1 viene passato, l'applicazione viene inserita come applicazione con priorità più alta per il supporto o la modalità richiesta; viene rimosso da una posizione con priorità inferiore, se già presente nell'elenco. Qualsiasi altro valore genera un errore.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAILLINEERR_INVALPOINTER.

Commenti

Se viene restituito LINEERR_INVALMEDIAMODE, il valore specificato in dwMediaMode non è zero e non una delle costanti LINEMEDIAMODE_.

Questa funzione aggiorna l'elenco di priorità archiviato. Se il sistema di telefonia viene inizializzato, imposta anche le priorità attive correnti per le applicazioni in esecuzione; la nuova priorità viene usata nella chiamata in arrivo successiva o lineHandoff in base al tipo di supporto.

Le priorità impostate con lineSetAppPriority verranno mantenute tra i riavvii del sistema o i riavvii di tapisrv. La funzione lineOpen apre la riga senza priorità di chiamata specificate. Per impostazione predefinita, l'applicazione con priorità più alta sarà quella denominata lineOpen.