phoneConfigDialog 함수(tapi.h)

아티클
03/05/2024

phoneConfigDialog 함수를 사용하면 지정된 휴대폰 디바이스의 공급자가 사용자가 dwDeviceID로 지정된 휴대폰 디바이스와 관련된 매개 변수를 구성할 수 있는 모달 대화 상자(애플리케이션의 hwndOwner 매개 변수에 연결됨)를 표시합니다.

구문

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

매개 변수

dwDeviceID

구성할 휴대폰 디바이스의 식별자입니다.

hwndOwner

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

lpszDeviceClass

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

반환 값

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

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

설명

lpszDeviceClass 매개 변수를 사용하면 애플리케이션이 사용자가 관심이 있는 디바이스 클래스에 적용되는 구성 정보의 특정 하위 화면을 선택할 수 있습니다. 허용된 문자열은 phoneGetID와 동일합니다. 예를 들어 휴대폰이 웨이브 API를 지원하는 경우 lpszDeviceClass 로 "wave/in"을 전달하면 공급자가 웨이브와 관련된 매개 변수를 표시하게 됩니다(또는 적어도 다단계 구성 대화 상자 체인의 해당 지점에서 시작하여 관련 매개 변수를 검색할 필요가 없음).

lpszDeviceClass 매개 변수는 공급자가 휴대폰의 최상위 구성을 표시하도록 하려면 "tapi/phone", "" 또는 NULL이어야 합니다.