TSPI_phoneClose 함수(tspi.h)
TSPI_phoneClose 함수는 디바이스에서 모든 미해결 비동기 작업을 완료하거나 중단한 후 지정된 개방형 휴대폰 디바이스를 닫습니다.
구문
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
매개 변수
hdPhone
닫을 휴대폰에 대한 서비스 공급자의 불투명 핸들입니다. 휴대폰이 성공적으로 닫힌 후에는 이 핸들이 더 이상 유효하지 않습니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
설명
서비스 공급자는 모든 비동기 작업에 대한 완료를 보고해야 합니다. 이 프로시저가 미해결 비동기 작업이 있는 휴대폰에 대해 호출되는 경우 이 프로시저가 반환되기 전에 적절한 결과 또는 오류 코드로 작업이 완료된 것으로 보고되어야 합니다. 일반적으로 TAPI는 이러한 항목이 순서대로 완료되기를 기다립니다. 그러나 서비스 공급자는 "중단" 또는 "긴급 종료" 상황에서 TSPI_phoneClose 대한 조기 호출을 처리할 준비가 되어 있어야 합니다.
이 프로시저가 반환되면 서비스 공급자는 휴대폰에서 더 이상 이벤트를 보고하지 않아야 합니다. 휴대폰에 대한 서비스 공급자의 불투명 핸들이 잘못되었습니다.
서비스 공급자는 휴대폰이 열려 있는 동안 예약한 공유 불가능한 리소스를 포기해야 합니다. 예를 들어 comm 포트 및 모뎀을 통해 액세스하는 휴대폰을 닫으면 comm 포트가 닫혀 다른 애플리케이션에서 사용할 수 있게 됩니다.
이 함수는 특별한 경우를 제외하고 항상 성공해야 합니다. 대부분의 호출자는 발생하는 오류를 보상할 수 없으므로 반환 코드를 무시할 수 있습니다. 지정된 반환 값은 개발 진단 목적으로 무엇보다 권고가 더 큽니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |