lineRegisterRequestRecipient 함수(tapi.h)

아티클
03/05/2024

lineRegisterRequestRecipient 함수는 호출하는 애플리케이션을 지정된 요청 모드에 대한 요청 수신자로 등록합니다.

구문

LONG lineRegisterRequestRecipient(
  HLINEAPP hLineApp,
  DWORD    dwRegistrationInstance,
  DWORD    dwRequestMode,
  DWORD    bEnable
);

매개 변수

hLineApp

TAPI의 줄 부분에 대한 애플리케이션의 사용 핸들입니다.

dwRegistrationInstance

LINE_REQUEST 메시지의 매개 변수로 다시 전달되는 애플리케이션별 DWORD입니다. 이 메시지는 요청이 보류 중임을 애플리케이션에 알 수 있습니다. bEnable이 0으로 설정된 경우 이 매개 변수는 무시됩니다. 이 매개 변수는 등록에 대해서만 TAPI에서 검사되며 등록 취소에는 검사되지 않습니다. 등록 취소하는 동안 사용되는 dwRegistrationInstance 값은 요청 모드를 등록하는 동안 사용된 dwRegistrationInstance 와 일치하지 않아도 됩니다.

dwRequestMode

애플리케이션이 등록하는 요청의 유형입니다. 이 매개 변수는 LINEREQUESTMODE_ 상수 중 하나 이상을 사용합니다.

bEnable

TRUE이면 애플리케이션이 지정된 요청 모드를 등록합니다. FALSE이면 애플리케이션이 지정된 요청 모드에 대해 등록을 취소합니다.

반환 값

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

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

전화 통신 사용 애플리케이션은 tapiRequestMakeCall을 호출하여 호출을 대신하도록 요청할 수 있습니다. 또한 다른 애플리케이션은 지정된 호출로 정보를 기록하도록 요청할 수 있습니다. tapiRequestMakeCall 요청은 TAPI에서 큐에 대기하고 요청을 처리하기 위해 등록된 가장 높은 우선 순위 애플리케이션은 보류 중인 요청 모드를 나타내는 LINE_REQUEST 메시지를 보냅니다. 이 애플리케이션은 일반적으로 사용자의 호출 제어 애플리케이션입니다.

다음으로, 이 메시지를 수신하는 호출 제어 애플리케이션은 요청 모드와 요청을 보유할 수 있을 만큼 큰 버퍼를 지정하여 lineGetRequest를 호출합니다. 그런 다음, 호출 제어 애플리케이션은 요청을 해석하고 실행합니다.

또한 수신자 애플리케이션은 lineShutdown을 수행할 때 모든 요청에 대해 자동으로 등록 취소됩니다.