TUISPICREATEDIALOGINSTANCEPARAMS-Struktur (tspi.h)

Definiert Parameter für TAPI-Dialogvorgänge.

Syntax

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

Member

dwRequestID

Die dwRequestID wird an den Dienstanbieter als Parameter in der asynchronen TSPI-Funktion übergeben, der die spontane Benutzeroberfläche zugeordnet ist. TAPI verwendet dies, um die Anwendung zu identifizieren, in deren Kontext die UI-DLL geladen und die TUISPI_providerGenericDialog-Funktion aufgerufen werden soll.

hdDlgInst

Der Bezeichner des Dienstanbieters für die Zuordnung mit dem instance des generischen Dialogfelds. Da mehrere Instanzen des generischen Dialogfelds in derselben oder mehreren Anwendungen geöffnet sein können, muss der Dienstanbieter sicherstellen, dass sein Handle innerhalb des Bereichs vorhandener Instanzen im Kontext des Anbieters eindeutig ist.

htDlgInst

TAPI schreibt seinen Bezeichner für die erstellte Zuordnung in dieses Mitglied. Dieser Member wird auf NULL festgelegt, wenn beim Erstellen der Zuordnung ein Fehler aufgetreten ist. In diesem Fall ist es für den Dienstanbieter unmöglich, ein Dialogfeld spontan im Kontext der Zielanwendung zu erstellen. Der Dienstanbieter muss diesen Bezeichner in Nachrichten verwenden, um Daten an die UI-DLL (LINE_SENDDIALOGINSTANCEDATA) zu senden.

lpszUIDLLName

Zeiger auf eine NULL-beendete Zeichenfolge, die den vollqualifizierten Namen der UI-DLL angibt, die im Anwendungskontext geladen werden soll.

lpParams

Zeiger auf einen privaten Parameterblock, der an die TUISPI_providerGenericDialog-Funktion der UI-DLL übermittelt werden soll. Der Dienstanbieter und die UI-DLL bestimmen den Inhalt des Parameterblocks. Die Übertragung erfolgt unidirektional; Die UI-DLL kann den Parameterblock nicht ändern und an den Dienstanbieter zurückgeben. Im Allgemeinen weist dieser Block die UI-DLL an, welches Dialogfeld angezeigt werden soll, und enthält die anzuzeigenden Informationen (falls erforderlich).

dwSize

Die Größe des Parameterblocks in Bytes.

Anforderungen

Weitere Informationen

LINE_SENDDIALOGINSTANCEDATA

TUISPI_providerGenericDialog