funzione TSPI_providerInstall (tspi.h)

Articolo
03/03/2024

La funzione TSPI_providerInstall è obsoleta. I provider di servizi TAPI versione 1.4 o precedenti possono implementare questa funzione TSPI. TAPI versione 2.0 o successiva implementa TUISPI_providerInstall.

La funzione TSPI_providerInstall installa eventuali "pezzi" aggiuntivi del provider nelle directory corrette (o almeno verificando che siano presenti), configura le voci del Registro di sistema del provider per le linee e i telefoni e crea tutte le altre voci necessarie per il provider di servizi. Viene chiamato dall'utilità Telefonia Pannello di controllo (fornita con La telefonia di Windows nelle versioni 1.4 e versioni precedenti) quando viene premuto il pulsante Aggiungi.

Sintassi

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parametri

hwndOwner

Handle della finestra padre in cui la funzione può creare qualsiasi finestra di dialogo richiesta durante l'installazione.

dwPermanentProviderID

Identificatore permanente del provider di servizi.

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_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM.

Commenti

Questa funzione completa l'installazione di altre parti richieste dal provider di servizi dopo che sono state eseguite le voci nella sezione [Provider] nel Registro di sistema. Se il provider di servizi richiede eventuali voci privatemente definite nel Registro di sistema per un'operazione appropriata, è necessario installare anche. Un modo tipico per installare questa sezione con le relative voci consiste nel chiamare TSPI_providerConfig.

Questa funzione deve lasciare il sistema in uno stato coerente. Deve essere eseguito al completamento, non consentendo all'utente di interrompere l'installazione al termine dell'installazione. Se l'installazione ha esito negativo, è responsabilità del provider eseguire il "backout" e restituire un errore. Ciò può implicare la pre-analisi per verificare che sia possibile eseguire un'installazione completa prima dell'inizio dell'installazione.

Questa funzione viene chiamata una sola volta, durante l'installazione del provider di servizi, fino a quando non è presente una chiamata a TSPI_providerRemove. Deve essere chiamato prima di qualsiasi altra funzione definita da TSPI.

L'utilità Telefonia Pannello di controllo fornita con La telefonia Windows nelle versioni 1.4 e versioni precedenti chiama questa funzione (con requisiti di sequenza esterna soddisfatti come descritto qui) quando viene richiamato il comando "add". Non chiama TSPI_providerConfig per il comando "add".

Non esiste alcuna funzione corrispondente a livello TAPI. A questo livello, le applicazioni prevedono che i provider di servizi siano già installati. Le applicazioni in esecuzione vengono informate sulla riconfigurazione dinamica tramite il valore LINEDEVSTATE_REINIT o PHONESTATE_REINIT nel messaggio LINE_LINEDEVSTATE o PHONE_STATE.