다음을 통해 공유


lineSetAgentState 함수(tapi.h)

lineSetAgentState 함수는 특정 주소와 연결된 에이전트 상태를 설정합니다.

구문

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

매개 변수

hLine

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

dwAddressID

에이전트 정보를 변경할 주소의 식별자입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

dwAgentState

새 에이전트 상태입니다. 에이전트 상태를 변경하지 않고 다음 상태만 수정하려면 LINEAGENTSTATE_ 상수 중 하나이거나 0이어야 합니다.

dwNextAgentState

주소의 현재 호출이 유휴 상태가 되면 자동으로 설정해야 하는 에이전트 상태입니다. 예를 들어 호출 후 작업을 수행해야 하는 것으로 알려진 경우 이 필드는 현재 호출 후 에이전트에 새 호출이 할당되지 않도록 LINEAGENTSTATE_WORKAFTERCALL 설정할 수 있습니다. 에이전트에 대해 구성된 기본 다음 상태를 사용하려면 LINEAGENTSTATE_ 상수 중 하나이거나 0이어야 합니다.

반환 값

비동기 작업이 시작되면 양수 요청 식별자를 반환합니다. 그렇지 않으면 함수는 다음 음수 오류 값 중 하나를 반환합니다.

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

요구 사항

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

추가 정보

보조 회선 서비스 함수

TAPI 2.2 참조 개요