Función de devolución de llamada TUISPIDLLCALLBACK (tspi.h)
La DLL de la interfaz de usuario llama a la función Dll de DllCallbackProc para enviar un bloque de parámetros privado al proveedor de servicios. Cada invocación de la devolución de llamada da como resultado una llamada a la función TSPI_providerGenericDialogData del proveedor de servicios asociado al objeto especificado. El contenido del bloque de parámetros se define mediante el proveedor de servicios y el archivo DLL de la interfaz de usuario. El proveedor de servicios puede modificar el contenido del bloque de parámetros; cuando esta función vuelve a devolver, TAPI copia los datos modificados en el bloque de parámetros dll de la interfaz de usuario original.
El tipo TUISPIDLLCALLBACK define un puntero a esta función de devolución de llamada. DllCallbackProc es un marcador de posición para el nombre de función definido por la aplicación.
Sintaxis
TUISPIDLLCALLBACK Tuispidllcallback;
LONG Tuispidllcallback(
DWORD_PTR dwObjectID,
DWORD dwObjectType,
LPVOID lpParams,
DWORD dwSize
)
{...}
Parámetros
dwObjectID
Identificador de objeto del tipo especificado por dwObjectType.
dwObjectType
Una de las constantes TUISPIDLL_OBJECT_ , especificando el tipo de objeto identificado por dwObjectID
TUISPIDLL_OBJECT_LINEID
El parámetro dwObjectID es un identificador de dispositivo de línea (dwDeviceID). Esto se usa cuando se invoca la devolución de llamada durante el procesamiento de TUISPI_lineConfigDialog o TUISPI_lineConfigDialogEdit.
TUISPIDLL_OBJECT_PHONEID
El parámetro dwObjectID es un identificador de dispositivo telefónico (dwDeviceID). Se usa cuando se invoca la devolución de llamada durante el procesamiento de TUISPI_phoneConfigDialog.
TUISPIDLL_OBJECT_PROVIDERID
El parámetro dwObjectID es un identificador de proveedor permanente. Esto se usa cuando se invoca la devolución de llamada durante el procesamiento de TUISPI_providerConfig, TUISPI_providerInstall o TUISPI_providerRemove.
TUISPIDLL_OBJECT_DIALOGINSTANCE
El parámetro dwObjectID es un HDRVDIALOGINSTANCE, tal como se devuelve al proveedor de servicios cuando envió un mensaje de LINE_CREATEDIALOGINSTANCE . Se usa cuando se invoca la devolución de llamada durante el procesamiento de TUISPI_providerGenericDialog.
lpParams
Puntero a un área de memoria usada para contener un bloque de parámetros.
dwSize
Tamaño en bytes del bloque de parámetros.
Valor devuelto
Devuelve cero si se ejecuta correctamente o uno de estos valores de error negativos:
LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |