funzione TSPI_lineGetIcon (tspi.h)

La funzione TSPI_lineGetIcon recupera un'icona specifica del dispositivo della riga di servizio da visualizzare all'utente.

Sintassi

LONG TSPIAPI TSPI_lineGetIcon(
  DWORD   dwDeviceID,
  LPCWSTR lpszDeviceClass,
  LPHICON lphIcon
);

Parametri

dwDeviceID

Dispositivo linea di cui è richiesta l'icona.

lpszDeviceClass

Puntatore a una stringa Unicode con terminazione Null che identifica un nome di classe del dispositivo. Questa classe di dispositivo consente al chiamante di selezionare un'icona specifica per la classe del dispositivo. Questo parametro è facoltativo e può essere lasciato NULL, nel qual caso è selezionata l'icona di livello più alto associata al dispositivo linea anziché un dispositivo di flusso multimediale specificato.

Le stringhe consentite sono uguali a per TSPI_lineGetID. Ad esempio, se la riga supporta l'API Comm, il passaggio di comm/datamodem come lpszDeviceClass fa sì che il provider restituisca un'icona correlata in modo specifico alle funzioni del dispositivo Comm del provider di servizi.

lphIcon

Puntatore a una posizione di memoria in cui viene restituito l'handle per l'icona.

Valore restituito

Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

Commenti

Il provider deve restituire un handle (in DWORD a cui punta lphIcon) a una risorsa icona (ottenuta da
Funzione LoadIcon ) associata alla riga specificata.

Un provider può scegliere di supportare molte icone (selezionate da lpszDeviceClass e/o numero di riga), una singola icona (ad esempio per il produttore, che verrebbe restituita per tutte le richieste di TSPI_lineGetIcon indipendentemente dall'oggetto lpszDeviceClass selezionato) o nessuna icona, nel qual caso imposta la DWORD a cui punta lphIcon su NULL. TAPI esamina l'handle restituito dal provider e, se il provider restituisce NULL, TAPI sostituisce un'icona di telefonia generica (l'icona "linea" generica).

Requisiti

Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

TSPI_lineConfigDialog

TSPI_lineGetID