TUISPI_providerRemove 함수(tspi.h)
TUISPI_providerRemove 함수는 사용자에게 서비스 공급자 제거를 확인하도록 요청합니다. 이 함수는 버전 2.0 이상에서 TSPI_providerRemove 함수를 더 이상 사용되지 않습니다(버전 1.4 이하에서 지원됨).
서비스 공급자가 addProvider 시간에 추가한 레지스트리 항목과 더 이상 필요하지 않은 다른 모듈 및 파일을 제거하는 것은 서비스 공급자의 책임입니다.
구현은 선택 사항입니다.
구문
LONG TSPIAPI TUISPI_providerRemove(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HWND hwndOwner,
DWORD dwPermanentProviderID
);
매개 변수
lpfnUIDLLCallback
UI DLL이 호출하여 서비스 공급자 DLL과 통신하여 대화 상자를 표시하는 데 필요한 정보를 가져올 수 있는 함수에 대한 포인터입니다.
hwndOwner
제거 중에 함수가 필요한 대화 상자 창을 만들 수 있는 부모 창의 핸들입니다.
dwPermanentProviderID
서비스 공급자의 영구 공급자 식별자입니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM.
설명
이 함수는 성공을 반환하는 경우 모든 서비스 공급자의 프라이빗 정의 정보가 레지스트리에서 제거되도록 보장해야 합니다.
이 절차는 시스템을 일관된 상태로 유지해야 합니다. 사용자가 부분적으로 완료될 때 제거를 중단할 수 없도록 완료될 때 실행되어야 합니다. 제거에 실패하면 수행된 작업을 "철회"하고 오류를 반환하는 것은 공급자의 책임입니다. 이는 제거가 시작되기 전에 전체 제거가 가능한지 확인하기 위해 사전 검사를 암시할 수 있습니다.
서비스 공급자가 사용 중인 동안(즉, TSPI_providerInit TSPI_providerShutdown 사이에) 이 함수를 호출할 수 있습니다. 이 경우 서비스 공급자는 사용자 대화 상자를 표시하여 충돌을 알리고 제거를 확인하거나, 투명하게 수행할 수 있는 옵션으로 제거 옵션을 제한하거나, LINE_CLOSE 및 PHONE_CLOSE 메시지를 발급하여 TAPI 및 애플리케이션에 영향을 받는 디바이스가 강제로 제거되었음을 알리는 적절한 조합을 수행해야 합니다. 어쨌든 TSPI를 통해 표시되는 동작에 영향을 주는 변경 내용은 다음 TSPI_providerShutdown 서비스 공급자가 종료되는 경우에만 적용됩니다.
TAPI 수준의 해당 함수는 lineRemoveProvider입니다. 이 수준에서 애플리케이션에는 서비스 공급자가 이미 설치되어 있어야 합니다. 그렇지 않으면 해당 줄과 휴대폰이 사용 가능한 디바이스 식별자 시퀀스 내에 표시되지 않습니다. LINE_CREATE 메시지는 동적 재구성에 대해 실행 중인 애플리케이션에 알릴 수 있습니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |