TUISPIDLLCALLBACK 콜백 함수(tspi.h)

아티클
08/26/2023

DllCallbackProc 함수는 UI DLL에 의해 호출되어 프라이빗 매개 변수 블록을 서비스 공급자에게 보냅니다. 콜백을 호출할 때마다 지정된 개체와 연결된 서비스 공급자에서 TSPI_providerGenericDialogData 함수를 호출합니다. 매개 변수 블록의 내용은 서비스 공급자 및 UI DLL에 의해 정의됩니다. 서비스 공급자는 매개 변수 블록의 내용을 수정할 수 있습니다. 이 함수가 반환되면 TAPI는 수정된 데이터를 원래 UI DLL 매개 변수 블록에 다시 복사합니다.

TUISPIDLLCALLBACK 형식은 이 콜백 함수에 대한 포인터를 정의합니다. DllCallbackProc 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

TUISPIDLLCALLBACK Tuispidllcallback;

LONG Tuispidllcallback(
  DWORD_PTR dwObjectID,
  DWORD dwObjectType,
  LPVOID lpParams,
  DWORD dwSize
)
{...}

매개 변수

dwObjectID

dwObjectType으로 지정된 형식의 개체 식별자입니다.

dwObjectType

dwObjectID로 식별되는 개체의 형식을 지정하는 TUISPIDLL_OBJECT_ 상수 중 하나입니다.

TUISPIDLL_OBJECT_LINEID

dwObjectID 매개 변수는 줄 디바이스 식별자(dwDeviceID)입니다. 이는 TUISPI_lineConfigDialog 또는 TUISPI_lineConfigDialogEdit 처리하는 동안 콜백이 호출될 때 사용됩니다.

TUISPIDLL_OBJECT_PHONEID

dwObjectID 매개 변수는 휴대폰 디바이스 식별자(dwDeviceID)입니다. 이는 TUISPI_phoneConfigDialog 처리하는 동안 콜백이 호출될 때 사용됩니다.

TUISPIDLL_OBJECT_PROVIDERID

dwObjectID 매개 변수는 영구 공급자 식별자입니다. TUISPI_providerConfig, TUISPI_providerInstall 또는 TUISPI_providerRemove 처리하는 동안 콜백이 호출될 때 사용됩니다.

TUISPIDLL_OBJECT_DIALOGINSTANCE

dwObjectID 매개 변수는 LINE_CREATEDIALOGINSTANCE 메시지를 보낼 때 서비스 공급자에게 반환되는 HDRVDIALOGINSTANCE입니다. 이는 TUISPI_providerGenericDialog 처리하는 동안 콜백이 호출될 때 사용됩니다.

lpParams

매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다.

dwSize

매개 변수 블록의 크기(바이트)입니다.

참고 구조의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.