lineGetLineDevStatus 함수(tapi.h)

아티클
03/02/2024

lineGetLineDevStatus 함수를 사용하면 애플리케이션이 현재 상태 대해 지정된 열린 줄 디바이스를 쿼리할 수 있습니다.

구문

LONG lineGetLineDevStatus(
  HLINE           hLine,
  LPLINEDEVSTATUS lpLineDevStatus
);

매개 변수

hLine

쿼리할 열린 줄 디바이스에 대한 핸들입니다.

lpLineDevStatus

LINEDEVSTATUS 형식의 고정 크기 데이터 구조에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조체는 줄의 디바이스 상태 채워집니다. lineGetLineDevStatus를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

반환 값

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

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

설명

애플리케이션은 lineGetLineDevStatus를 사용하여 현재 줄 상태 대한 라인 디바이스를 쿼리합니다. 이 상태 정보는 줄 디바이스의 모든 주소에 전역적으로 적용됩니다. lineGetAddressStatus를 사용하여 줄의 특정 주소에 대한 상태 정보를 확인합니다.