TUISPI_providerInstall 함수(tspi.h)

아티클
08/26/2023

TUISPI_providerInstall 함수의 구현은 서비스 공급자가 공급자의 추가 "조각"을 올바른 디렉터리에 설치(또는 최소한 해당 디렉터리에 있는지 확인)하고 공급자에 필요한 레지스트리 항목을 설정할 수 있는 기회입니다. 이 함수는 버전 2.0 이상에서 TSPI_providerInstall 함수를 더 이상 사용되지 않습니다(버전 1.4 이하에서 지원됨).

서비스 공급자가 적절한 작업을 위해 레지스트리에 비공개로 정의된 항목이 필요한 경우 현재 설치해야 합니다.

구현은 선택 사항입니다.

구문

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

매개 변수

lpfnUIDLLCallback

UI DLL이 호출하여 서비스 공급자 DLL과 통신하여 대화 상자를 표시하는 데 필요한 정보를 가져올 수 있는 함수에 대한 포인터입니다.

hwndOwner

함수가 설치하는 동안 필요한 대화 상자 창을 만들 수 있는 부모 창의 핸들입니다.

dwPermanentProviderID

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

반환 값

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

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM. LINEERR_INVALPARAM.

설명

이 함수는 시스템을 일관된 상태로 유지해야 합니다. 사용자가 부분적으로 완료될 때 설치를 중단할 수 없도록 완료될 때 실행되어야 합니다. 설치에 실패하면 수행된 작업을 "백아웃"하고 오류를 반환하는 것은 공급자의 책임입니다. 이는 설치가 시작되기 전에 전체 설치가 가능한지 확인하기 위한 사전 검사를 암시할 수 있습니다.

이 함수는 TUISPI_providerRemove 호출될 때까지 서비스 공급자를 설치하는 동안 두 번 이상 호출할 수 있습니다. 그러나 서비스 공급자가 공급자의 여러 인스턴스를 요구하거나 지원하지 않는 경우 LINEERR_ 상수 LINEERR_NOMULTIPLEINSTANCE 반환합니다.

TAPI 수준의 해당 함수는 lineAddProvider입니다. LINE_CREATE 메시지는 동적 재구성에 대해 실행 중인 애플리케이션에 알릴 수 있습니다.