다음을 통해 공유

TSPI_phoneConfigDialog 함수(tspi.h)

  • 아티클

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

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

구문

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

매개 변수

dwDeviceID

구성할 휴대폰 디바이스입니다.

hwndOwner

대화 상자 창을 배치할 부모 창에 대한 핸들입니다.

lpszDeviceClass

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

반환 값

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

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.

설명

TSPI_phoneConfigDialog 서비스 공급자가 모달 대화 상자를 hWndOwner 의 자식 창으로 표시하여 사용자가 dwDeviceID로 지정된 휴대폰과 관련된 매개 변수를 구성할 수 있도록 합니다. lpszDeviceClass 매개 변수를 사용하면 애플리케이션이 사용자가 관심 있는 디바이스 클래스에 적용할 수 있는 구성 정보의 특정 하위 화면을 선택할 수 있습니다. 허용되는 문자열은 TSPI_phoneGetID 와 동일합니다. 예를 들어 휴대폰이 Comm API를 지원하는 경우 comm/datamodem을 lpszDeviceClass 로 전달하면 공급자가 Comm과 관련된 매개 변수를 표시합니다(또는 적어도 사용자가 원하는 매개 변수를 찾기 위해 검색할 필요가 없도록 다단계 구성 대화 상자 체인의 해당 지점에서 시작). szDeviceClass 매개 변수는 공급자가 휴대폰의 최상위 구성을 표시하도록 하려면 "tapi/phone", "" 또는 NULL이어야 합니다.

프로시저는 Win.ini 파일의 [Windows 전화 통신] 섹션을 업데이트하고, 애플리케이션에 표시되는 구조의 내용(예: PHONECAPS)에 영향을 주는 Telephon.ini 변경하거나 휴대폰 디바이스를 만들거나 제거하는 경우 WM_WININICHANGE 메시지를 브로드캐스트해야 합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tspi.h

추가 정보

PHONECAPS

TSPI_phoneGetID