TUISPI_lineConfigDialog 함수(tspi.h)

아티클
08/26/2023

TUISPI_lineConfigDialog 함수를 사용하면 지정된 줄 디바이스의 공급자가 모달 대화 상자를 hwndOwner의 자식 창으로 표시하여 사용자가 줄 디바이스와 관련된 매개 변수를 구성할 수 있습니다. 이 함수는 버전 2.0 이상에서 TSPI_lineConfigDialog 함수를 더 이상 사용되지 않습니다(버전 1.4 이하에서 지원됨).

구현은 선택 사항입니다.

구문

LONG TSPIAPI TUISPI_lineConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

매개 변수

lpfnUIDLLCallback

UI DLL이 호출하여 서비스 공급자 DLL과 통신하여 대화 상자를 표시하는 데 필요한 정보를 얻고 업데이트된 구성을 서비스 공급자에게 보낼 수 있는 함수에 대한 포인터입니다.

dwDeviceID

구성할 줄 디바이스입니다.

hwndOwner

대화 상자 창을 배치할 부모 창에 대한 핸들입니다.

lpszDeviceClass

디바이스 클래스 이름을 식별하는 null로 끝나는 문자열에 대한 포인터입니다. 이 디바이스 클래스를 사용하면 호출자가 해당 디바이스 클래스에 적용할 수 있는 구성 정보의 특정 하위 화면을 선택할 수 있습니다. 이 매개 변수가 NULL 이거나 빈 문자열인 경우 가장 높은 수준의 구성 대화 상자를 선택해야 합니다. 허용되는 문자열은 TSPI_lineGetID 경우와 동일합니다. 예를 들어 줄이 Comm API를 지원하는 경우 comm/datamodem을 lpszDeviceClass 로 전달하면 공급자가 Comm과 관련된 매개 변수를 표시합니다(또는 적어도 사용자가 원하는 매개 변수를 찾기 위해 검색할 필요가 없도록 다단계 구성 대화 상자 체인의 해당 지점에서 시작).

반환 값

함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

설명

줄이 닫힌 경우에만 호출될 TUISPI_lineConfigDialog 제한이 없습니다. 그러나 각 공급자는 이러한 제한 자체를 적용할 수 있습니다. TUISPI_lineConfigDialog 호출되면 공급자는 사용자에게 "줄이 하나 이상의 애플리케이션에서 사용 중이라는 메시지를 표시할 수 있습니다. 줄이 사용 중인 동안에는 줄 구성을 변경할 수 없습니다." 오류 메시지 LINEERR_INUSE 반환합니다. 그러나 일부 구성은 특히 미디어 유형(예: 모뎀 오류 제어 프로토콜)과 관련된 미디어 유형과 관련된 구성을 "즉시" 변경하는 것이 안전할 수 있습니다. 특히 해당 미디어 형식이 현재 사용되지 않는 경우 그렇습니다. 공급자는 줄이 열려 있는 동안 이러한 옵션을 변경할 수 있습니다.

사용자는 먼저 줄을 강제로 닫지 않고 LINEDEVCAPS 또는 LINEADDRESSCAPS 로 반환되는 값을 변경하는 모든 것을 변경할 수 없습니다. 애플리케이션이 정확한 정보를 갖기 위해 이러한 구조를 반환하는 함수를 호출해야 한다는 신호입니다.