lineConfigDialog 함수(tapi.h)

아티클
08/26/2023

lineConfigDialog 함수를 사용하면 지정된 줄 디바이스의 공급자가 대화 상자(애플리케이션의 hwndOwner에 연결됨)를 표시하여 사용자가 줄 디바이스와 관련된 매개 변수를 구성할 수 있습니다.

구문

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

매개 변수

dwDeviceID

구성할 라인 디바이스의 식별자입니다.

hwndOwner

대화 상자를 연결할 창에 대한 핸들입니다. 함수 중에 만든 창에 소유자 창이 없어야 함을 나타내는 NULL 일 수 있습니다.

lpszDeviceClass

디바이스 클래스 이름을 식별하는 null로 끝나는 문자열에 대한 포인터입니다. 이 디바이스 클래스를 사용하면 애플리케이션이 해당 디바이스 클래스에 적용할 수 있는 구성 정보의 특정 하위 화면을 선택할 수 있습니다. 이 매개 변수는 선택 사항이며 NULL 또는 빈 상태로 둘 수 있습니다. 이 경우 가장 높은 수준의 구성이 선택됩니다.

반환 값

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

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

설명

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

lpszDeviceClass 매개 변수는 "tapi/line" , "" 또는 NULL이므로 공급자가 줄에 대해 가장 높은 수준의 구성을 표시합니다.