TSPI_providerInstall 함수(tspi.h)

아티클
08/26/2023

TSPI_providerInstall 함수는 사용되지 않습니다. TAPI 버전 1.4 이하 서비스 공급자는 이 TSPI 함수를 구현할 수 있습니다. TAPI 버전 2.0 이상 TSP는 TUISPI_providerInstall 구현합니다.

TSPI_providerInstall 함수는 공급자의 추가 "조각"을 올바른 디렉터리에 설치하고(또는 최소한 해당 디렉터리에 있는지 확인) 해당 줄 및 휴대폰에 대한 공급자의 레지스트리 항목을 설정하고 서비스 공급자에 필요한 다른 항목을 만듭니다. 추가 단추를 누를 때 전화 통신 제어판 유틸리티(버전 1.4 이하의 Windows Telephony와 함께 제공됨)에서 호출됩니다.

구문

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

매개 변수

hwndOwner

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

dwPermanentProviderID

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

반환 값

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

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM.

설명

이 함수는 레지스트리의 [공급자] 섹션에 있는 항목이 만들어진 후 서비스 공급자가 요구하는 다른 부분의 설치를 완료합니다. 서비스 공급자가 적절한 작업을 위해 레지스트리에 비공개로 정의된 추가 항목이 필요한 경우 설치해야 합니다. 항목과 함께 이 섹션을 설치하는 일반적인 방법은 TSPI_providerConfig 호출하는 것입니다.

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

이 함수는 서비스 공급자를 설치하는 동안 TSPI_providerRemove 호출될 때까지 한 번만 호출됩니다. 다른 TSPI 정의 함수 앞에 호출해야 합니다.

버전 1.4 및 이전 버전에서 Windows Telephony와 함께 제공되는 전화 통신 제어판 유틸리티는 "add" 명령이 호출될 때 이 함수를 호출합니다(여기에 설명된 대로 외부 시퀀스 요구 사항이 충족됨). "add" 명령에 대한 TSPI_providerConfig 호출하지 않습니다.

TAPI 수준에는 해당 함수가 없습니다. 해당 수준에서 애플리케이션에는 서비스 공급자가 이미 설치되어 있어야 합니다. 실행 중인 애플리케이션은 LINE_LINEDEVSTATE 또는 PHONE_STATE 메시지의 LINEDEVSTATE_REINIT 또는 PHONESTATE_REINIT 값을 통해 동적 재구성에 대해 알 수 있습니다.