Share via

lineGetMessage 함수(tapi.h)

  • 아티클

lineGetMessage 함수는 이벤트 핸들 알림 메커니즘을 사용하는 애플리케이션에 배달을 위해 큐에 대기 중인 다음 TAPI 메시지를 반환합니다(자세한 내용은 lineInitializeEx 참조).

구문

LONG lineGetMessage(
  HLINEAPP      hLineApp,
  LPLINEMESSAGE lpMessage,
  DWORD         dwTimeout
);

매개 변수

hLineApp

lineInitializeEx에서 반환된 핸들입니다. 애플리케이션은 LINEINITIALIZEEXPARAMS 구조체의 dwOptions 멤버에서 LINEINITIALIZEEXOPTION_USEEVENT 옵션을 설정해야 합니다.

lpMessage

LINEMESSAGE 구조체에 대한 포인터입니다. 이 함수에서 성공적으로 반환되면 구조체에 애플리케이션 배달을 위해 큐에 대기된 다음 메시지가 포함됩니다.

dwTimeout

시간 제한 간격(밀리초)입니다. 함수는 메시지를 반환할 수 없는 경우에도 간격이 경과하면 를 반환합니다. dwTimeout이 0이면 함수는 대기 중인 메시지를 확인하고 즉시 반환합니다. dwTimeout이 INFINITE이면 함수의 제한 시간 간격이 경과하지 않습니다.

반환 값

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

LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_NOMEM.

설명

lineGetMessage 함수가 0이 아닌 시간 제한으로 호출되고 애플리케이션이 다른 스레드에서 lineShutdown을 호출하는 경우 이 함수는 LINEERR_INVALAPPHANDLE 즉시 반환합니다.

시간 제한이 만료되거나 0이면 큐에서 메시지를 가져올 수 없으면 함수는 오류 LINEERR_OPERATIONFAILED 함께 반환합니다.

요구 사항

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

추가 정보

LINEINITIALIZEEXPARAMS

LINEMESSAGE

lineInitializeEx

lineShutdown