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

함수의 이 instance 서비스 공급자의 특정 요청에 연결을 바인딩하는 불투명 식별자입니다. UI DLL은 추가 데이터를 요청하거나 서비스 공급자에게 데이터를 배달하기 위해 TUISPIDLLCALLBACK 에 대한 모든 호출에서 TUISPI_OBJECT_DIALOGINSTANCE 함께 이 매개 변수를 포함해야 합니다.

lpParams

매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 이 매개 변수 블록의 내용은 서비스 공급자 및 관련 UI DLL에 따라 다릅니다. 이 매개 변수 블록을 통한 데이터 전달은 UI DLL에 대한 단방향입니다. 매개 변수 블록에 대한 변경 내용은 서비스 공급자에 다시 반영되지 않습니다. 일반적으로 이 매개 변수 블록은 UI DLL이 처음에 대화 상자를 표시하는 데 필요한 모든 정보를 포함합니다.

dwSize

매개 변수 블록의 크기(바이트)입니다. lpParams 매개 변수가 문자열에 대한 포인터인 경우 크기는 null 종결자를 포함해야 합니다.

hEvent

TAPI에서 만든 이벤트 개체에 대한 핸들입니다. 이 이벤트는 UI DLL이 instance 이 대화 상자의 초기화를 완료하고 TUISPI_providerGenericDialogData 통해 추가 대화 상자 데이터를 받을 준비가 되면 SetEvent(hEvent)를 통해 UI DLL에 의해 신호를 받습니다. 이 대화 상자 instance LINE_SENDDIALOGINSTANCEDATA 통해 연결된 서비스 공급자가 보낸 데이터는 UI DLL이 이 이벤트에 신호를 보낼 때까지 TAPI에 의해 차단되어 TUISPI_providerGenericDialog 필요한 초기화를 수행할 수 있는 기회를 제공합니다. UI DLL은 TUISPI_providerGenericDialogData 대한 호출을 차단하지 않도록 가능한 한 빨리 이벤트를 신호해야 합니다.