lineGetStatusMessages 함수(tapi.h)

아티클
03/13/2024

lineGetStatusMessages 함수를 사용하면 애플리케이션이 지정된 줄 또는 주소의 변경 내용과 관련된 이벤트에 대해 수신하도록 설정된 알림 메시지를 쿼리할 수 상태.

구문

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

매개 변수

hLine

줄 디바이스에 대한 핸들입니다.

lpdwLineStates

애플리케이션에 보낼 메시지를 변경할 줄 디바이스 상태 식별하는 비트 배열입니다. 플래그가 TRUE이면 해당 메시지가 사용하도록 설정됩니다. FALSE이면 사용하지 않도록 설정됩니다. 이 매개 변수는 하나 이상의 LINEDEVSTATE_ 상수를 사용합니다.

lpdwAddressStates

메시지를 변경할 상태 주소를 식별하는 비트 배열은 애플리케이션으로 전송됩니다. 플래그가 TRUE이면 해당 메시지가 사용하도록 설정됩니다. FALSE이면 사용하지 않도록 설정됩니다. 이 매개 변수는 하나 이상의 LINEADDRESSSTATE_ 상수를 사용합니다.

반환 값

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

TAPI는 줄과 주소에서 발생하는 이벤트에 대해 애플리케이션에 알리는 여러 메시지를 정의합니다. 애플리케이션은 모든 주소 및 줄 상태 변경 메시지를 받는 데 관심이 없을 수 있습니다. lineSetStatusMessages 함수를 사용하여 애플리케이션이 수신할 메시지를 선택할 수 있습니다. 기본적으로 주소 상태 및 줄 상태 보고는 사용하지 않도록 설정됩니다.