phoneGetDevCaps 함수(tapi.h)

아티클
08/26/2023

phoneGetDevCaps 함수는 지정된 전화 장치를 쿼리하여 전화 통신 기능을 확인합니다.

구문

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

매개 변수

hPhoneApp

TAPI를 사용하여 애플리케이션 등록을 처리합니다.

dwDeviceID

쿼리할 휴대폰 디바이스의 식별자입니다.

dwAPIVersion

사용할 전화 통신 API의 버전 번호입니다. 상위 단어에는 주 버전 번호가 포함됩니다. 하위 단어에는 부 버전 번호가 포함됩니다. 이 번호는 함수 phoneNegotiateAPIVersion을 사용하여 가져옵니다.

dwExtVersion

사용할 서비스 공급자별 확장의 버전 번호입니다. 이 번호는 함수 phoneNegotiateExtVersion을 사용하여 가져옵니다. 디바이스별 확장을 사용하지 않는 경우 0으로 둘 수 있습니다. 그렇지 않으면 상위 단어에 주 버전 번호가 포함됩니다. 하위 단어에는 부 버전 번호가 포함됩니다.

lpPhoneCaps

PHONECAPS 형식의 고정 크기 구조체에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조는 전화 장치 기능 정보로 채워집니다.

반환 값

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

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.