TUISPI_providerGenericDialog函式 (tspi.h)

發行項
08/26/2023

當服務提供者傳送LINE_CREATEDIALOGINSTANCE訊息時，會呼叫 UI DLL 中的TUISPI_providerGenericDialog函式。服務提供者會使用此方法來在應用程式內容中建立對話方塊，並搭配處理特定的非同步 TSPI 函式。此函式是從特別為了顯示對話方塊而建立的執行緒呼叫。在終結對話方塊之前，UI DLL 不會從此函式傳回。

如果與 UI DLL 相關聯的服務提供者傳送LINE_CREATEDIALOGINSTANCE訊息，以在應用程式內容中建立對話方塊，則實作是必要的。

語法

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

參數

lpfnUIDLLCallback

UI DLL 可以呼叫的函式指標，以與服務提供者 DLL 通訊，以取得顯示對話方塊所需的資訊。

htDlgInst

不透明識別碼會將此函式實例的關聯系結至服務提供者的特定要求。 UI DLL 必須在對 TUISPIDLLCALLBACK 的任何呼叫中包含此參數以及TUISPI_OBJECT_DIALOGINSTANCE，以要求進一步的資料，或將資料傳遞至服務提供者。

lpParams

用來保存參數區塊的記憶體區域指標。此參數區塊的內容專屬於服務提供者及其相關聯的 UI DLL。透過此參數區塊傳達資料是 UI DLL 的單向;對參數區塊所做的變更不會反映在服務提供者中。一般而言，此參數區塊會保留 UI DLL 一開始顯示對話方塊所需的所有資訊。

dwSize

參數區塊位元組的大小。如果 lpParams 參數是字串的指標，大小必須包含 Null 結束字元。

hEvent

TAPI 所建立之事件物件的控制碼。當 UI DLL 完成此對話方塊實例的初始化時，UI DLL 會透過 SetEvent (hEvent) 發出訊號，並準備好透過 TUISPI_providerGenericDialogData接收其他對話方塊資料。 TAPI 會封鎖透過此對話方塊實例的LINE_SENDDIALOGINSTANCEDATA) (所傳送的資料，直到 UI DLL 發出此事件的訊號，讓 TUISPI_providerGenericDialog 有機會執行任何必要的初始化。 UI DLL 應該儘快發出訊號，以避免封鎖 對TUISPI_providerGenericDialogData的呼叫。