lineGetProviderList 함수(tapi.h)

  • 아티클

lineGetProviderList 함수는 현재 전화 통신 시스템에 설치된 서비스 공급자 목록을 반환합니다.

구문

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

매개 변수

dwAPIVersion

애플리케이션에서 지원하는 가장 높은 버전의 TAPI(특정 라인 디바이스에서 lineNegotiateAPIVersion 으로 협상된 값이 반드시 있는 것은 아님).

lpProviderList

TAPI가 LINEPROVIDERLIST 구조를 반환할 수 있는 메모리 위치에 대한 포인터입니다. lineGetProviderList를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

참고 구조체의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.
 

반환 값

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.

요구 사항

   
대상 플랫폼 Windows
헤더 tapi.h
라이브러리 Tapi32.lib
DLL Tapi32.dll

추가 정보

LINEPROVIDERLIST

보조 회선 서비스 함수

TAPI 2.2 참조 개요

lineNegotiateAPIVersion