다음을 통해 공유


lineConfigDialogA 함수(tapi.h)

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

구문

LONG lineConfigDialogA(
  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이므로 공급자가 줄에 대해 가장 높은 수준의 구성을 표시합니다.

참고

tapi.h 헤더는 lineConfigDialog를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 tapi.h
라이브러리 Tapi32.lib
DLL Tapi32.dll

추가 정보

기본 전화 통신 서비스 참조

TAPI 2.2 참조 개요

lineGetID