Condividi tramite


Funzione lineSetAppPriority (tapi.h)

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.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi.h
Libreria Tapi32.lib
DLL Tapi32.dll

Vedi anche

LINEEXTENSIONID

Funzioni supplementari del servizio line

Panoramica dei riferimenti a TAPI 2.2

lineHandoff