Estructura TUISPICREATEDIALOGINSTANCEPARAMS (tspi.h)

Define parámetros para las operaciones de diálogo TAPI.

Sintaxis

typedef struct tuispicreatedialoginstanceparams_tag {
  DRV_REQUESTID       dwRequestID;
  HDRVDIALOGINSTANCE  hdDlgInst;
  HTAPIDIALOGINSTANCE htDlgInst;
  LPCWSTR             lpszUIDLLName;
  LPVOID              lpParams;
  DWORD               dwSize;
} TUISPICREATEDIALOGINSTANCEPARAMS, *LPTUISPICREATEDIALOGINSTANCEPARAMS;

Miembros

dwRequestID

DwRequestID pasado al proveedor de servicios como parámetro en la función asincrónica de TSPI con la que está asociada la interfaz de usuario espontánea. TAPI lo usa para identificar la aplicación en cuyo contexto se cargará el archivo DLL de la interfaz de usuario y se invocará la función TUISPI_providerGenericDialog .

hdDlgInst

Identificador del proveedor de servicios para la asociación con la instancia del cuadro de diálogo genérico. Dado que es posible que varias instancias del cuadro de diálogo genérico estén abiertas en las mismas o varias aplicaciones, el proveedor de servicios debe asegurarse de que su identificador sea único dentro del ámbito de las instancias existentes en el contexto del proveedor.

htDlgInst

TAPI escribe en este miembro su identificador para la asociación que se crea. Este miembro se establece en NULL si se produce un error en la creación de la asociación, en cuyo caso es imposible que el proveedor de servicios cree un cuadro de diálogo de forma espontánea en el contexto de la aplicación de destino. El proveedor de servicios debe usar este identificador en los mensajes para enviar datos al archivo DLL de interfaz de usuario (LINE_SENDDIALOGINSTANCEDATA).

lpszUIDLLName

Puntero a una cadena terminada en NULL que especifica el nombre completo del archivo DLL de la interfaz de usuario que se va a cargar en el contexto de la aplicación.

lpParams

Puntero a un bloque de parámetros privado que se va a transmitir a la función TUISPI_providerGenericDialog del archivo DLL de la interfaz de usuario. El proveedor de servicios y la DLL de la interfaz de usuario determinan el contenido del bloque de parámetros. La transferencia es unidireccional; el archivo DLL de la interfaz de usuario no puede modificar el bloque de parámetros y devolverlo al proveedor de servicios. Por lo general, este bloque indica al archivo DLL de la interfaz de usuario qué cuadro de diálogo se va a mostrar y contiene la información que se va a mostrar (si es necesario).

dwSize

Tamaño, en bytes, del bloque de parámetros.

Requisitos

Consulte también

LINE_SENDDIALOGINSTANCEDATA

TUISPI_providerGenericDialog