funzione TUISPI_providerInstall (tspi.h)

Articolo
03/13/2024

L'implementazione della funzione TUISPI_providerInstall è l'opportunità del provider di servizi di installare eventuali "parti" aggiuntive del provider nelle directory corrette (o almeno verificare che siano presenti) e configurare le voci del Registro di sistema necessarie per il provider. Questa funzione rende obsoleta la funzione TSPI_providerInstall nella versione 2.0 e successive (supportata nella versione 1.4 e precedenti).

Se il provider di servizi richiede voci definite privatamente nel Registro di sistema per il corretto funzionamento, è necessario installarle in questo momento.

L'implementazione è facoltativa.

Sintassi

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Parametri

lpfnUIDLLCallback

Puntatore a una funzione che la DLL dell'interfaccia utente può chiamare per comunicare con la DLL del provider di servizi per ottenere le informazioni necessarie per visualizzare la finestra di dialogo.

hwndOwner

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

dwPermanentProviderID

Identificatore del provider di servizi permanente.

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 deve lasciare il sistema in uno stato coerente. Deve essere eseguita fino al completamento, non consentendo all'utente di interrompere l'installazione al termine dell'installazione. Se l'installazione non riesce, è 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 può essere richiamata più volte durante l'installazione del provider di servizi, fino a quando non viene eseguita una chiamata a TUISPI_providerRemove. Se il provider di servizi non richiede o supporta più istanze del provider, tuttavia restituisce la costante LINEERR_ LINEERR_NOMULTIPLEINSTANCE .

La funzione corrispondente a livello TAPI è lineAddProvider. Il messaggio LINE_CREATE informa le applicazioni in esecuzione sulla riconfigurazione dinamica.