TUISPI_lineConfigDialogEdit 함수(tspi.h)

아티클
08/26/2023

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

구현은 선택 사항입니다.

구문

LONG TSPIAPI TUISPI_lineConfigDialogEdit(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass,
  LPVOID const      lpDeviceConfigIn,
  DWORD             dwSize,
  LPVARSTRING       lpDeviceConfigOut
);

매개 변수

lpfnUIDLLCallback

UI DLL이 호출하여 서비스 공급자 DLL과 통신하여 대화 상자를 표시하는 데 필요한 정보를 가져올 수 있는 함수에 대한 포인터입니다.

dwDeviceID

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

hwndOwner

대화 상자를 연결할 창에 대한 핸들입니다.

lpszDeviceClass

디바이스 클래스 이름을 식별하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 디바이스 클래스를 사용하면 호출자가 해당 디바이스 클래스에 적용되는 구성 정보의 특정 하위 화면을 선택할 수 있습니다. 이 매개 변수가 NULL 이거나 빈 문자열을 가리키는 경우 가장 높은 수준의 구성이 선택됩니다. 허용되는 문자열은 TSPI_lineGetID 경우와 동일합니다.

lpDeviceConfigIn

VARSTRING 구조체의 변수 부분에서 TSPI_lineGetDevConfig(또는 이전 TUISPI_lineConfigDialogEdit 호출)에서 반환된 불투명 구성 데이터 구조에 대한 포인터입니다.

dwSize

lpDeviceConfigIn이 가리키는 구조체의 바이트 수입니다. 이 값은 TSPI_lineGetDevConfig 또는 TUISPI_lineConfigDialogEdit 이전 호출에서 반환된 VARSTRING구조체의dwStringSize 멤버에 반환됩니다.

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

lpDeviceConfigOut

디바이스 구성 구조가 반환되는 VARSTRING 형식의 메모리 위치에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 위치는 디바이스 구성으로 채워집니다. VARSTRING 구조체의 dwStringFormat 멤버는 STRINGFORMAT_BINARY. lineGetDevConfig(또는 lineConfigDialogEdit의 향후 호출)를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에서 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

반환 값

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

LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL, LINEERR_NOMEM.

설명

lpszDeviceClass 매개 변수는 사용자가 관심이 있는 디바이스 클래스에 적용할 수 있는 구성 정보의 특정 하위 화면을 선택합니다. 허용되는 문자열은 TSPI_lineGetID 와 동일합니다. 예를 들어 줄이 Comm API를 지원하는 경우 comm/datamodem을 lpszDeviceClass 로 전달하면 공급자가 Comm과 관련된 매개 변수를 표시합니다(또는 적어도 다단계 구성 대화 상자 체인의 해당 지점에서 시작하므로 사용자가 관심 있는 매개 변수를 찾기 위해 "발굴"할 필요가 없음).

lpszDeviceClass 매개 변수는 "tapi/line", "" 또는 NULL이므로 공급자가 줄에 대한 최상위 구성을 표시합니다.

이 함수와 TUISPI_lineConfigDialog 차이점은 편집할 매개 변수의 원본과 편집 결과입니다. TUISPI_lineConfigDialog 편집된 매개 변수는 현재 디바이스에서 사용 중인 매개 변수(또는 다음 호출 시 사용하도록 설정됨)이며, 변경된 모든 변경 내용은 활성 연결에 즉각적인 영향을 줍니다. 또한 애플리케이션은 lineGetDevConfig를 사용하여 TUISPI_lineConfigDialog 매개 변수 변경 결과를 가져와야 합니다. TUISPI_lineConfigDialogEdit 사용하면 편집할 매개 변수가 애플리케이션에서 전달되고 결과는 활성 연결에 영향을 주지 않고 애플리케이션으로 반환됩니다. 편집 결과는 이 함수와 함께 반환되며 애플리케이션은 lineGetDevConfig를 호출할 필요가 없습니다. 따라서 TUISPI_lineConfigDialogEdit 사용자가 활성 호출에 영향을 주지 않고 향후 호출에 대한 매개 변수를 설정할 수 있는 기능을 애플리케이션에 제공할 수 있습니다. 그러나 이 함수의 출력을 TSPI_lineSetDevConfig 전달하여 현재 호출 또는 다음 호출에 영향을 줄 수 있습니다.

이전 버전과의 호환성을 위해 이 함수는 이전 서비스 공급자가 내보내지 않습니다. TAPI는 이 조건을 검색하고 애플리케이션이 이전 공급자에서 이 함수를 호출하려고 하면 LINEERR_OPERATIONUNAVAIL 보고합니다.