lineGetAddressStatus 함수(tapi.h)

lineGetAddressStatus 함수를 사용하면 애플리케이션이 현재 상태 대해 지정된 주소를 쿼리할 수 있습니다.

구문

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

매개 변수

hLine

열린 줄 디바이스에 대한 핸들입니다.

dwAddressID

지정된 오픈 라인 디바이스의 주소입니다. 쿼리할 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

lpAddressStatus

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

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

 

반환 값

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

LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

요구 사항

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

추가 정보

기본 전화 통신 서비스 참조

LINEADDRESSSTATUS

TAPI 2.2 참조 개요