lineRemoveProvider 함수(tapi.h)

아티클
03/05/2024

lineRemoveProvider 함수는 전화 통신 시스템에서 기존 전화 통신 서비스 공급자를 제거합니다.

구문

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

매개 변수

dwPermanentProviderID

제거할 서비스 공급자의 영구 공급자 식별자입니다.

hwndOwner

제거 프로세스의 일부로 표시해야 하는 대화 상자(예: 서비스 공급자의 TSPI_providerRemove 함수에 의한 확인 대화 상자)가 연결되는 창에 대한 핸들입니다. 함수 중에 만든 창에 소유자 창이 없어야 함을 나타내는 NULL 값일 수 있습니다.

반환 값

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

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.

설명

TSPI_providerRemove 대한 호출이 성공하고 당시 전화 통신 시스템이 활성화된 경우 TAPI는 서비스 공급자에서 lineShutdown 및/또는 phoneShutdown을 호출합니다(활성 디바이스 유형에 따라). 연결된 디바이스의 애플리케이션에서 여전히 보유하고 있는 모든 회선 또는 전화 핸들은 LINE_CLOSE 또는 PHONE_CLOSE 메시지로 강제로 닫힙니다(서비스 공급자가 사용자 확인 후 TSPI_providerRemove 일부로 이러한 메시지를 발급하는 것이 좋습니다). 이전에 해당 공급자의 제어 하에 있는 디바이스는 "사용할 수 없음"으로 표시되므로 나중에 애플리케이션에서 디바이스 식별자로 참조하려고 하면 LINEERR_NODRIVER.