TSPI_lineConfigDialog 함수(tspi.h)

아티클
03/03/2024

TSPI_lineConfigDialog 함수는 사용되지 않습니다. TAPI 버전 1.4 이하 서비스 공급자는 이 TSPI 함수를 구현할 수 있습니다. TAPI 버전 2.0 이상 TSP는 TUISPI_lineConfigDialog 구현합니다.

TSPI_lineConfigDialog 함수를 사용하면 지정된 줄 디바이스의 공급자가 모달 대화 상자를 hwndOwner의 자식 창으로 표시하여 사용자가 줄 디바이스와 관련된 매개 변수를 구성할 수 있도록 합니다.

구문

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

매개 변수

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.

설명

프로시저는 Win.ini 파일의 [Windows 전화 통신] 섹션을 업데이트하고 Telephon.ini 파일을 변경하여 LINEDEVCAPS 또는 LINEADDRESSCAPS에서 보고된 줄 또는 주소 기능을 변경하거나 줄 디바이스를 만들거나 제거하는 경우 WM_WININICHANGE 메시지를 브로드캐스트해야 합니다.

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

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