LINEADDRESSSTATUS 구조체(tapi.h)

아티클
08/26/2023

LINEADDRESSSTATUS 구조체는 주소의 현재 상태 설명합니다. lineGetAddressStatus 함수와 TSPI_lineGetAddressStatus 함수는 LINEADDRESSSTATUS 구조를 반환합니다.

구문

typedef struct lineaddressstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumInUse;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwAddressFeatures;
  DWORD dwNumRingsNoAnswer;
  DWORD dwForwardNumEntries;
  DWORD dwForwardSize;
  DWORD dwForwardOffset;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
} LINEADDRESSSTATUS, *LPLINEADDRESSSTATUS;

멤버

dwTotalSize

이 데이터 구조에 할당된 총 크기(바이트)입니다.

dwNeededSize

반환된 모든 정보를 바이트 단위로 유지하는 데 필요한 이 데이터 구조의 크기입니다.

dwUsedSize

유용한 정보를 포함하는 이 데이터 구조의 부분 크기(바이트)입니다.

dwNumInUse

현재 주소를 사용하는 스테이션의 수입니다.

dwNumActiveCalls

유휴, onhold, onholdpendingtransfer 및 onholdpendingconference 이외의 호출 상태에 있는 주소의 호출 수입니다.

dwNumOnHoldCalls

onhold 상태의 주소에 대한 호출 수입니다.

dwNumOnHoldPendCalls

onholdpendingtransfer 또는 onholdpendingconference 상태의 주소에 대한 호출 수입니다.

dwAddressFeatures

현재 상태의 주소에서 호출할 수 있는 주소 관련 함수입니다. 이 멤버는 하나 이상의 LINEADDRFEATURE_ 상수를 사용합니다.

dwNumRingsNoAnswer

응답되지 않은 통화가 응답 없음으로 간주되기 전에 이 주소에 대해 설정된 링 수입니다.

dwForwardNumEntries

dwForwardSize 및 dwForwardOffset에서 참조하는 배열의 항목 수입니다.

dwForwardSize

전달 정보 배열의 크기(바이트)입니다.

dwForwardOffset

구조체의 시작 부분에서 주소의 전달 정보를 설명하는 고정 크기 필드로 오프셋됩니다. 이 정보는 LINEFORWARD 형식의 dwForwardNumEntries 요소 배열입니다. 배열의 주소 오프셋은 LINEADDRESSSTATUS 구조체의 시작 부분을 기준으로 합니다. dwForwardOffset이 가리키는 LINEFORWARD 형식의 고정 크기 필드에 있는 dwCallerAddressOffset 및 dwDestAddressOffset 오프셋은 LINEADDRESSSTATUS 데이터 구조의 시작 부분("루트" 컨테이너)을 기준으로 합니다. 배열의 크기는 dwForwardSize로 지정됩니다.

dwTerminalModesSize

터미널 모드 배열의 크기(바이트)입니다.

dwTerminalModesOffset

구조체의 시작 부분에서 하나 이상의 LINETERMMODE_ 상수를 사용하는 DWORD 크기 항목이 있는 배열이 포함된 고정 크기 디바이스 필드로 오프셋됩니다. 이 배열은 0에서 dwNumTerminals보다 작은 범위의 터미널 식별자에 의해 인덱싱됩니다. 배열의 각 항목은 이 주소에 대한 lineSetTerminal 함수를 사용하여 해당 터미널 집합의 현재 터미널 모드를 지정합니다. 배열의 크기는 dwTerminalModesSize로 지정됩니다.

dwDevSpecificSize

디바이스별 필드의 크기(바이트)입니다.

dwDevSpecificOffset

이 구조체의 시작 부분에서 변함없이 크기가 조정된 디바이스별 필드로 오프셋됩니다. 필드의 크기는 dwDevSpecificSize로 지정됩니다.

설명

디바이스별 확장은 이 데이터 구조의 DevSpecific(dwDevSpecificSize 및 dwDevSpecificOffset) 크기의 영역을 사용해야 합니다.

이 데이터 구조는 lineGetAddressStatus 함수에 의해 반환됩니다. 이 데이터 구조의 항목이 주소에 대한 활동의 결과로 변경되면 애플리케이션에 LINE_ADDRESSSTATE 메시지가 전송됩니다. 이 메시지에 대한 매개 변수는 이 레코드의 상태 항목이 변경되었음을 나타내는 LINEADDRESSSTATE_ 상수 중 하나인 주소 상태입니다.