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 |