lineClose 함수(tapi.h)

아티클
08/26/2023

lineClose 함수는 지정된 열린 줄 디바이스를 닫습니다.

구문

LONG lineClose(
  HLINE hLine
);

매개 변수

hLine

닫을 열린 줄 디바이스에 대한 핸들입니다. 줄이 성공적으로 닫힌 후에는 이 핸들이 더 이상 유효하지 않습니다.

반환 값

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

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

설명

열려 있는 줄에 활성 호출이 있는 동안 애플리케이션이 lineClose 를 호출하는 경우 이러한 호출에 대한 애플리케이션의 소유권이 해지됩니다. 애플리케이션이 이러한 호출의 유일한 소유자인 경우 호출도 삭제됩니다. 애플리케이션이 소유권을 명시적으로 포기하거나 선을 닫기 전에 이러한 호출을 삭제하여 열린 줄에서 소유하는 호출을 삭제하는 것이 좋은 프로그래밍 방법입니다.

줄이 성공적으로 닫히면 열린/닫기 변경 상태 줄을 모니터링하는 모든 애플리케이션에 LINE_LINEDEVSTATE 메시지가 전송됩니다. 미해결 비동기 회신은 표시되지 않습니다.

서비스 공급자는 선이 열려 있는 애플리케이션에서 라인 디바이스를 강제로 회수하는 것이 유용하거나 필요할 수 있습니다. 이는 애플리케이션이 라인 디바이스를 너무 오랫동안 독점하지 못하도록 하는 데 유용할 수 있습니다. 이 경우 닫힌 라인 디바이스의 줄 핸들을 지정하여 LINE_CLOSE 메시지가 애플리케이션에 전송됩니다.

lineOpen 함수는 호출하는 애플리케이션에 리소스를 할당하고, 리소스를 사용할 수 없는 경우 애플리케이션이 줄을 열지 못하도록 방지할 수 있습니다. 따라서 가끔 회선 디바이스(예: 발신 호출)를 사용하는 애플리케이션은 리소스를 해제하기 위해 줄을 닫고 다른 애플리케이션이 줄을 열 수 있도록 해야 합니다.