phoneSetStatusMessages 함수(tapi.h)

아티클
08/26/2023

phoneSetStatusMessages 함수를 사용하면 애플리케이션이 선택한 상태 이벤트에 대해 지정된 휴대폰 디바이스를 모니터링할 수 있습니다.

구문

LONG phoneSetStatusMessages(
  HPHONE hPhone,
  DWORD  dwPhoneStates,
  DWORD  dwButtonModes,
  DWORD  dwButtonStates
);

매개 변수

hPhone

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

dwPhoneStates

휴대폰 상태 애플리케이션이 알림 메시지를 받을 수 있는 변경 내용 및 이벤트 집합입니다. 이 매개 변수에는 PHONESTATE_ 상수 중 0개 이상이 있을 수 있습니다.

dwButtonModes

애플리케이션이 알림 메시지를 받을 수 있는 전화 단추 모드 집합입니다. 이 매개 변수에는 PHONEBUTTONMODE_ 상수 중 0개 이상이 있을 수 있습니다.

dwButtonStates

애플리케이션에서 알림 메시지를 받을 수 있는 전화 단추 상태의 집합이 변경됩니다. dwButtonModes 매개 변수가 0이면 dwButtonStates는 무시됩니다. dwButtonModes에 하나 이상의 비트가 설정된 경우 이 매개 변수에도 하나 이상의 비트 집합이 있어야 합니다. 이 매개 변수는 PHONEBUTTONSTATE_ 상수를 사용합니다.

반환 값

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.