funzione lineSetAppPriorityA (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 di rimuoverla dall'elenco di priorità.

Sintassi

LONG lineSetAppPriorityA(
  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 lungo o 8.3.

dwMediaMode

Tipo di supporto per il quale deve essere impostata la priorità dell'applicazione. Il valore può essere rappresentato da 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 viene passato il valore 0, 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 viene passato il valore 1, 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 possibili valori restituiti sono:

LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.

Osservazioni

Se LINEERR_INVALMEDIAMODE viene restituito, 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 che prima ha chiamato lineOpen.

Nota

L'intestazione tapi.h definisce lineSetAppPriority come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

LINEEXTENSIONID

funzioni supplementari del servizio linea

panoramica dei riferimenti TAPI 2.2

lineHandoff