ClearCommError 함수(winbase.h)

아티클
03/03/2024

통신 오류에 대한 정보를 검색하고 통신 디바이스의 현재 상태 보고합니다. 통신 오류가 발생할 때 함수가 호출되고 디바이스의 오류 플래그를 지워 추가 입력 및 출력(I/O) 작업을 사용하도록 설정합니다.

구문

BOOL ClearCommError(
  [in]            HANDLE    hFile,
  [out, optional] LPDWORD   lpErrors,
  [out, optional] LPCOMSTAT lpStat
);

매개 변수

[in] hFile

통신 디바이스에 대한 핸들입니다. CreateFile 함수는 이 핸들을 반환합니다.

[out, optional] lpErrors

오류 유형을 나타내는 마스크를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값	의미
CE_BREAK 0x0010	하드웨어에서 중단 조건을 감지했습니다.
CE_FRAME 0x0008	하드웨어에서 프레이밍 오류를 발견했습니다.
CE_OVERRUN 0x0002	문자 버퍼 오버런이 발생했습니다. 다음 문자가 손실됩니다.
CE_RXOVER 0x0001	입력 버퍼 오버플로가 발생했습니다. 입력 버퍼에 공간이 없거나 파일 끝(EOF) 문자 다음에 문자를 받았습니다.
CE_RXPARITY 0x0004	하드웨어에서 패리티 오류를 발견했습니다.

다음 값은 지원되지 않습니다.

[out, optional] lpStat

디바이스의 상태 정보가 반환되는 COMSTAT 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 상태 정보가 반환되지 않습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

통신 포트가 설정 DCB 구조의 fAbortOnError 멤버에 대한 TRUE 값으로 설정된 경우 통신 소프트웨어는 통신 오류가 발생할 때 통신 포트에서 모든 읽기 및 쓰기 작업을 종료합니다. 애플리케이션이 ClearCommError 함수를 호출하여 통신 오류를 승인할 때까지 새 읽기 또는 쓰기 작업이 허용되지 않습니다.

ClearCommError 함수는 lpStat 매개 변수가 가리키는 상태 버퍼를 hFile 매개 변수로 지정된 통신 디바이스의 현재 상태 채웁니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll