Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione lineGetAppPriority
Sintassi
LONG lineGetAppPriorityW(
LPCWSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPVARSTRING lpExtensionName,
LPDWORD lpdwPriority
);
Parametri
lpszAppFilename
Puntatore a una stringa contenente il nome del file del modulo eseguibile dell'applicazione, senza dati di directory. In API versione 2.0 o successiva, il parametro può essere in formato long file name, di cui il formato del nome file 8.3 è un subset appropriato. I nomi di file lunghi, a differenza dei nomi di file 8.3, conservano le maiuscole e minuscole. Nessuno dei due formati di nome file fa distinzione tra maiuscole e minuscole. Per altre informazioni, vedere convenzioni nome file. Nelle versioni api precedenti alla 2.0, il parametro deve specificare un nome file nel formato 8.3; non è possibile utilizzare nomi di file lunghi.
dwMediaMode
Modalità multimediale per cui ottenere i dati prioritari. Il valore può essere una delle costanti LINEMEDIAMODE_; solo un bit singolo può essere attivo. Il valore 0 deve essere utilizzato se si verifica la priorità dell'applicazione per le richieste di telefonia assistita.
lpExtensionID
Puntatore alla 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 verificata la priorità. Deve essere LINEREQUESTMODE_MAKECALL. Questo parametro viene ignorato se dwMediaMode è diverso da zero.
lpExtensionName
Questo parametro viene ignorato.
lpdwPriority
Puntatore a un DWORD-size memory location in cui TAPI scrive la priorità dell'applicazione per il supporto o la modalità richiesta specificata. Il valore 0 viene restituito se l'applicazione non è presente nell'elenco di priorità archiviato e non dispone attualmente di dispositivi line aperti con proprietà richiesta della modalità multimediale specificata o se è stata registrata per la modalità richiesta specificata.
Nelle versioni api precedenti alla 2.0, il valore -1 (0xFFFFFFFF) viene restituito se l'applicazione ha la riga aperta per la modalità multimediale specificata o è stata registrata per le richieste specificate, ma l'applicazione non è nell'elenco di priorità archiviato; vale a dire, si trova solo nell'elenco di priorità temporaneo. Nell'API versione 2.0 o successiva il valore 0 viene restituito per indicare questa condizione.
In caso contrario, il valore indica la posizione dell'applicazione nell'elenco; 1 come priorità più alta e valori crescenti che indicano una priorità decrescente.
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_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.
Osservazioni
Se viene restituito LINEERR_INVALMEDIAMODE, il valore specificato in dwMediaMode non è zero, non una modalità media estesa valida e non una delle costanti LINEMEDIAMODE_o più bit sono presenti nel valore del parametro.
Nota
L'intestazione tapi.h definisce lineGetAppPriority 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
funzioni supplementari del servizio linea