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 함께 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tapi.h |
| 라이브러리 | Tapi32.lib |
| DLL | Tapi32.dll |