lineAddProvider 함수(tapi.h)

아티클
08/26/2023

lineAddProvider 함수는 전화 통신 시스템에 새 전화 통신 서비스 공급자를 설치합니다.

구문

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

매개 변수

lpszProviderFilename

에 대한 포인터

추가할 서비스 공급자의 경로를 포함하는 null로 종료된 문자열입니다.

hwndOwner

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

lpdwPermanentProviderID

새로 설치된 서비스 공급자의 영구 공급자 식별자를 수신하는 변수에 대한 포인터입니다.

반환 값

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

LINEERR_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_OPERATIONFAILED.

설명

이 함수 호출 중에 TAPI는 해당 TSPI_providerInstall 함수를 호출하여 서비스 공급자에 액세스할 수 있는지 확인합니다. DLL 또는 함수를 찾을 수 없거나 TSPI_providerInstall 오류를 반환하는 경우 이 오류가 발생하면 함수가 실패하고 공급자가 전화 통신 시스템에 추가되지 않습니다. 이 작업이 성공하고 전화 통신 시스템이 활성 상태인 경우(하나 이상의 애플리케이션이 lineInitialize 또는 lineInitializeEx라고 함) TAPI는 새로 추가된 서비스 공급자를 시작하려고 시도하지 않습니다. 대신 새 서비스 공급자를 활성화하기 위해 TAPI에서 Windows를 다시 시작하는 메시지를 실행합니다. 활성화가 성공하면 애플리케이션은 LINE_CREATE 또는 PHONE_CREATE 메시지를 통해 만든 새 디바이스 또는 다시 초기화를 요청하는 LINE_LINEDEVSTATE 메시지(애플리케이션에서 CREATE 메시지를 지원하지 않는 경우)에 대해 알 수 있습니다.

이 함수는 서비스 공급자 DLL 자체나 지원 파일이 아닌 파일을 복사하지 않습니다. 공급자 추가를 관리하는 애플리케이션은 공급자가 TAPI(예: \WINDOWS, \WINDOWS\SYSTEM 또는 경로의 다른 위치)에서 찾을 수 있는 디렉터리에 설치되어 있는지 확인해야 합니다.