Funzione di callback TUISPIDLLCALLBACK (tspi.h)
La funzione DllCallbackProc viene chiamata dalla DLL dell'interfaccia utente per inviare un blocco di parametri privati al provider di servizi. Ogni chiamata del callback restituisce una chiamata alla funzione TSPI_providerGenericDialogData nel provider di servizi associato all'oggetto specificato. Il contenuto del blocco di parametri è definito dal provider di servizi e dalla DLL dell'interfaccia utente. Il provider di servizi può modificare il contenuto del blocco di parametri; quando questa funzione viene restituita, TAPI copia nuovamente i dati modificati nel blocco del parametro DLL dell'interfaccia utente originale.
Il tipo TUISPIDLLCALLBACK definisce un puntatore a questa funzione di callback. DllCallbackProc è un segnaposto per il nome della funzione definita dall'applicazione.
Sintassi
TUISPIDLLCALLBACK Tuispidllcallback;
LONG Tuispidllcallback(
DWORD_PTR dwObjectID,
DWORD dwObjectType,
LPVOID lpParams,
DWORD dwSize
)
{...}
Parametri
dwObjectID
Identificatore di oggetto del tipo specificato da dwObjectType.
dwObjectType
Una delle costanti TUISPIDLL_OBJECT_ , specificando il tipo di oggetto identificato da dwObjectID
TUISPIDLL_OBJECT_LINEID
Il parametro dwObjectID è un identificatore del dispositivo di riga (dwDeviceID). Viene usato quando il callback viene richiamato durante l'elaborazione di TUISPI_lineConfigDialog o TUISPI_lineConfigDialogEdit.
TUISPIDLL_OBJECT_PHONEID
Il parametro dwObjectID è un identificatore del dispositivo telefonico (dwDeviceID). Viene usato quando il callback viene richiamato durante l'elaborazione di TUISPI_phoneConfigDialog.
TUISPIDLL_OBJECT_PROVIDERID
Il parametro dwObjectID è un identificatore di provider permanente. Viene usato quando il callback viene richiamato durante l'elaborazione di TUISPI_providerConfig, TUISPI_providerInstall o TUISPI_providerRemove.
TUISPIDLL_OBJECT_DIALOGINSTANCE
Il parametro dwObjectID è HDRVDIALOGINSTANCE, come restituito al provider di servizi quando ha inviato un messaggio di LINE_CREATEDIALOGINSTANCE . Viene utilizzato quando il callback viene richiamato durante l'elaborazione di TUISPI_providerGenericDialog.
lpParams
Puntatore a un'area di memoria usata per contenere un blocco di parametri.
dwSize
Dimensione in byte del blocco di parametri.
Valore restituito
Restituisce zero se ha esito positivo o uno dei valori di errore negativi seguenti:
LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM LINEERR_OPERATIONFAILED.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |