Struttura TUISPICREATEDIALOGINSTANCEPARAMS (tspi.h)

Definisce i parametri per le operazioni della finestra di dialogo TAPI.

Sintassi

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

Members

dwRequestID

DwRequestID passato al provider di servizi come parametro nella funzione TSPI asincrona con cui è associata l'interfaccia utente spontanea. TAPI usa questa opzione per identificare l'applicazione nel cui contesto deve essere caricata la DLL dell'interfaccia utente e la funzione TUISPI_providerGenericDialog richiamata.

hdDlgInst

Identificatore del provider di servizi per l'associazione con l'istanza della finestra di dialogo generica. Poiché è possibile aprire più istanze della finestra di dialogo generica nello stesso o in più applicazioni, il provider di servizi deve assicurarsi che il relativo handle sia univoco nell'ambito delle istanze esistenti nel contesto del provider.

htDlgInst

TAPI scrive in questo membro il relativo identificatore per l'associazione creata. Questo membro è impostato su NULL se la creazione dell'associazione non è riuscita, nel qual caso non è possibile che il provider di servizi crei una finestra di dialogo spontaneamente nel contesto dell'applicazione di destinazione. Il provider di servizi deve usare questo identificatore nei messaggi per inviare dati alla DLL dell'interfaccia utente (LINE_SENDDIALOGINSTANCEDATA).

lpszUIDLLName

Puntatore a una stringa con terminazione NULL che specifica il nome completo della DLL dell'interfaccia utente da caricare nel contesto dell'applicazione.

lpParams

Puntatore a un blocco di parametri privati da trasmettere alla funzione TUISPI_providerGenericDialog della DLL dell'interfaccia utente. Il provider di servizi e la DLL dell'interfaccia utente determinano il contenuto del blocco di parametri. Il trasferimento è unidirectional; la DLL dell'interfaccia utente non è in grado di modificare il blocco dei parametri e restituirla al provider di servizi. In genere, questo blocco indica alla DLL dell'interfaccia utente di visualizzare e contiene le informazioni da visualizzare, se necessario.

dwSize

Dimensioni, in byte, del blocco di parametri.

Requisiti

Vedi anche

LINE_SENDDIALOGINSTANCEDATA

TUISPI_providerGenericDialog