phoneGetMessage 함수(tapi.h)

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

구문

LONG phoneGetMessage(
  HPHONEAPP      hPhoneApp,
  LPPHONEMESSAGE lpMessage,
  DWORD          dwTimeout
);

매개 변수

hPhoneApp

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

lpMessage

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

dwTimeout

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

반환 값

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

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_NOMEM.

설명

이 함수가 0이 아닌 시간 제한으로 호출되고 애플리케이션이 다른 스레드에서 phoneShutdown 을 호출하는 경우 이 함수는 PHONEERR_INVALAPPHANDLE 사용하여 즉시 반환됩니다.

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

요구 사항

추가 정보

PHONEINITIALIZEEXPARAMS

PHONEMESSAGE

phoneInitializeEx

phoneShutdown