función TUISPI_providerGenericDialog (tspi.h)

Artículo
03/08/2023

Se llama a la función TUISPI_providerGenericDialog en el archivo DLL de la interfaz de usuario cuando el proveedor de servicios envía un mensaje de LINE_CREATEDIALOGINSTANCE . El proveedor de servicios lo usa para crear cuadros de diálogo 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 creado específicamente para mostrar el cuadro de diálogo. El archivo DLL de la interfaz de usuario no vuelve de esta función hasta que se destruye el cuadro de diálogo.

La implementación es obligatoria si el proveedor de servicios asociado a la DLL de la interfaz de usuario envía mensajes LINE_CREATEDIALOGINSTANCE para crear de forma espontánea cuadros de diálogo en el contexto de la aplicación.

Sintaxis

LONG TSPIAPI TUISPI_providerGenericDialog(
  TUISPIDLLCALLBACK   lpfnUIDLLCallback,
  HTAPIDIALOGINSTANCE htDlgInst,
  LPVOID              lpParams,
  DWORD               dwSize,
  HANDLE              hEvent
);

Parámetros

lpfnUIDLLCallback

Puntero a una función a la que el archivo DLL de la interfaz de usuario puede llamar para comunicarse con el archivo DLL del proveedor de servicios para obtener información necesaria para mostrar el cuadro de diálogo.

htDlgInst

Identificador opaco que enlaza la asociación de esta instancia de la función a una solicitud determinada del proveedor de servicios. El archivo DLL de interfaz de usuario debe incluir este parámetro, junto con TUISPI_OBJECT_DIALOGINSTANCE, en cualquier llamada a TUISPIDLLCALLBACK para solicitar datos adicionales de o entregar datos al proveedor de servicios.

lpParams

Puntero a un área de memoria usada 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. Por lo general, este bloque de parámetros contiene toda la información que el archivo DLL de la interfaz de usuario necesita para mostrar inicialmente el cuadro de diálogo.

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 null .

hEvent

Identificador de un objeto de evento creado por TAPI. El archivo DLL de interfaz de usuario señala este evento a través de SetEvent (hEvent) cuando el archivo DLL de la interfaz de usuario ha completado la inicialización de esta instancia del cuadro de diálogo y está preparado para recibir datos adicionales del cuadro de diálogo a través de TUISPI_providerGenericDialogData. TapI bloquea los datos enviados por el proveedor de servicios asociado (a través de LINE_SENDDIALOGINSTANCEDATA) para esta instancia del cuadro de diálogo hasta que el archivo DLL de la interfaz de usuario señale este evento, lo que ofrece TUISPI_providerGenericDialog la oportunidad de realizar cualquier inicialización necesaria. El archivo DLL de la interfaz de usuario debe indicar el evento lo antes posible para evitar el bloqueo de llamadas a TUISPI_providerGenericDialogData.