TSPI_providerShutdown 함수(tspi.h)

아티클
08/26/2023

TSPI_providerShutdown 함수는 서비스 공급자를 종료합니다. 서비스 공급자는 진행 중인 모든 활동을 종료하고 할당된 모든 리소스를 해제합니다.

구문

LONG TSPIAPI TSPI_providerShutdown(
  DWORD dwTSPIVersion,
  DWORD dwPermanentProviderID
);

매개 변수

dwTSPIVersion

이 함수가 작동해야 하는 TSPI 정의의 버전입니다. 호출자는 특수dwDeviceIDINITIALIZE_NEGOTIATION TSPI_lineNegotiateTSPIVersion 또는 TSPI_phoneNegotiateTSPIVersion 사용하여 서비스 공급자가 허용할 수 있는 버전을 협상할 수 있습니다.

dwPermanentProviderID

이 매개 변수를 사용하면 서비스 공급자가 서비스 공급자의 가능한 여러 인스턴스 중 어떤 인스턴스가 종료되는지 확인할 수 있습니다. 매개 변수의 값은 TSPI_providerInit 같은 이름의 매개 변수에 전달된 값과 동일합니다.

반환 값

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.

설명

이 함수에 대한 최종 쌍 호출은 TSPI_line 접두사로 접두사로 지정된 TSPI 함수 또는 TSPI_lineNegotiateTSPIVersion 이외의 TSPI_phone또는 TSPI_phoneNegotiateTSPIVersion 마지막 호출이어야 합니다. 이를 보장하는 것은 호출자의 책임입니다.

이 함수는 특별한 경우를 제외하고 항상 성공해야 합니다. 대부분의 호출자는 발생하는 오류를 보상할 수 없으므로 반환 코드를 무시할 수 있습니다. 지정된 반환 값은 개발 진단 목적으로 무엇보다 권고가 더 큽니다.

TAPI에는 직접 해당하는 함수가 없습니다. TAPI에서는 작동할 instance 식별하는 "애플리케이션 핸들" 매개 변수를 사용하여 여러 다른 사용 인스턴스를 처리할 수 있습니다. TSPI에서 인터페이스 아키텍처는 각 고유 서비스 공급자에 대해 단일 사용 instance 지원합니다.