다음을 통해 공유

TUISPI_phoneConfigDialog 함수(tspi.h)

  • 아티클

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

구현은 선택 사항입니다.

구문

LONG TSPIAPI TUISPI_phoneConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

매개 변수

lpfnUIDLLCallback

UI DLL이 호출하여 서비스 공급자 DLL과 통신하여 대화 상자를 표시하는 데 필요한 정보를 얻고 업데이트된 구성을 서비스 공급자에게 보낼 수 있는 함수에 대한 포인터입니다.

dwDeviceID

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

hwndOwner

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

lpszDeviceClass

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

반환 값

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

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

설명

lpszDeviceClass 매개 변수를 사용하면 애플리케이션이 사용자가 관심 있는 디바이스 클래스에 적용할 수 있는 구성 정보의 특정 하위 화면을 선택할 수 있습니다. 허용되는 문자열은 TSPI_phoneGetID 와 동일합니다.

예를 들어 휴대폰이 Comm API를 지원하는 경우 comm/datamodem을 lpszDeviceClass 로 전달하면 공급자가 Comm과 관련된 매개 변수를 표시합니다(또는 적어도 사용자가 원하는 매개 변수를 찾기 위해 검색할 필요가 없도록 다단계 구성 대화 상자 체인의 해당 지점에서 시작). szDeviceClass 매개 변수는 공급자가 휴대폰의 최상위 구성을 표시하도록 하려면 "tapi/phone", "" 또는 NULL이어야 합니다.

요구 사항

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

추가 정보

PHONECAPS

TSPI_phoneGetID