다음을 통해 공유


phoneGetStatusMessages 함수(tapi.h)

phoneGetStatusMessages 함수는 지정된 전화 디바이스에서 어떤 전화 상태 변경 내용이 애플리케이션에 대한 콜백을 생성하는지 반환합니다.

구문

LONG phoneGetStatusMessages(
  HPHONE  hPhone,
  LPDWORD lpdwPhoneStates,
  LPDWORD lpdwButtonModes,
  LPDWORD lpdwButtonStates
);

매개 변수

hPhone

모니터링할 열린 휴대폰 디바이스에 대한 핸들입니다.

lpdwPhoneStates

PHONESTATE_ 상수 중 하나 이상인 0을 포함하는 DWORD에 대한 포인터입니다. 이러한 플래그는 애플리케이션이 알림 메시지를 받을 수 있는 전화 상태 변경 내용 및 이벤트 집합을 지정합니다. 모니터링은 개별적으로 사용하도록 설정하고 사용하지 않도록 설정할 수 있습니다.

lpdwButtonModes

애플리케이션이 알림 메시지를 받을 수 있는 전화 단추 모드 집합을 지정하는 플래그가 포함된 DWORD 에 대한 포인터입니다. 이 매개 변수는 PHONEBUTTONMODE_ 상수 중 하나 이상인 0을 사용합니다.

lpdwButtonStates

애플리케이션이 알림 메시지를 받을 수 있는 휴대폰 단추 상태 변경 집합을 지정하는 플래그가 포함된 DWORD 에 대한 포인터입니다. 이 매개 변수는 PHONEBUTTONSTATE_ 상수 중 하나 이상인 0을 사용합니다.

반환 값

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_UNINITIALIZED.

설명

애플리케이션은 phoneGetStatusMessages를 사용하여 해당 메시지의 생성을 쿼리할 수 있습니다. 메시지 생성은 phoneGetStatusMessages로 제어할 수 있습니다. 모든 전화 상태 메시지는 기본적으로 사용하지 않도록 설정됩니다.

요구 사항

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

추가 정보

PHONECAPS

PHONE_CLOSE

PHONE_STATE

보조 전화 서비스 기능

TAPI 2.2 참조 개요

phoneGetDevCaps

phoneSetStatusMessages