TUISPI_providerGenericDialogData función (tspi.h)
Se llama a la función TUISPI_providerGenericDialogData en el archivo DLL de la interfaz de usuario cuando el proveedor de servicios envía un mensaje LINE_SENDDIALOGINSTANCEDATA . El proveedor de servicios lo usa para actualizar espontáneamente la información en los cuadros de diálogo creados en el contexto de la aplicación junto con el procesamiento de funciones TSPI asincrónicas concretas. Se llama a esta función desde un subproceso independiente del que se está ejecutando TUISPI_providerGenericDialogData . El archivo DLL de la interfaz de usuario no debe bloquear el subproceso en el que se llama a esta función, pero debe procesar los datos y devolverlos inmediatamente (si es necesario, publicar un mensaje en el cuadro de diálogo).
La implementación es obligatoria si se exporta TUISPI_providerGenericDialog .
Sintaxis
LONG TSPIAPI TUISPI_providerGenericDialogData(
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize
);
Parámetros
htDlgInst
Identificador opaco que enlaza la asociación de esta instancia de la función a una solicitud determinada del proveedor de servicios.
lpParams
Puntero a un área de memoria utilizada para contener un bloque de parámetros. El contenido de este bloque de parámetros es específico del proveedor de servicios y su DLL de interfaz de usuario asociada. La transmisión de datos a través de este bloque de parámetros es unidireccional a la DLL de la interfaz de usuario; Los cambios realizados en el bloque de parámetros no se reflejan en el proveedor de servicios. Si este parámetro se establece en NULL, se trata de una solicitud para cerrar el cuadro de diálogo inmediatamente y limpiar ( TUISPIDLLCALLBACK no se debe invocar durante esta limpieza). TAPI invoca esta función con lpParams establecido en NULL para forzar la limpieza del cuadro de diálogo en determinadas circunstancias, como una aplicación que llama a lineShutdown con un cuadro de diálogo todavía activo.
dwSize
Tamaño en bytes del bloque de parámetros. Si el parámetro lpParams es un puntero a una cadena, el tamaño debe incluir el terminador nulo .
Valor devuelto
Devuelve cero si se ejecuta correctamente o uno de estos valores de error negativos:
LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |