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