TUISPI_lineConfigDialog 함수(tspi.h)
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 로 반환되는 값을 변경하는 모든 것을 변경할 수 없습니다. 애플리케이션이 정확한 정보를 갖기 위해 이러한 구조를 반환하는 함수를 호출해야 한다는 신호입니다.
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | tspi.h |