PeekConsoleInput 함수

아티클
07/12/2023

지정된 콘솔 입력 버퍼에서 데이터를 버퍼에서 제거하지 않고 읽습니다.

구문

BOOL WINAPI PeekConsoleInput(
  _In_  HANDLE        hConsoleInput,
  _Out_ PINPUT_RECORD lpBuffer,
  _In_  DWORD         nLength,
  _Out_ LPDWORD       lpNumberOfEventsRead
);

매개 변수

hConsoleInput [in]
콘솔 입력 버퍼에 대한 핸들입니다. 핸들에는 GENERIC_READ 액세스 권한이 있어야 합니다. 자세한 내용은 콘솔 버퍼 보안 및 액세스 권한을 참조하세요.

lpBuffer [out]
입력 버퍼 데이터를 수신하는 INPUT_RECORD 구조체 배열에 대한 포인터입니다.

nLength [in]
배열 요소에서 lpBuffer 매개 변수가 가리키는 배열의 크기입니다.

lpNumberOfEventsRead [out]
읽은 입력 레코드 수를 받는 변수에 대한 포인터입니다.

반환 값

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

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

설명

요청된 레코드 수가 버퍼에서 사용할 수 있는 레코드 수를 초과하면 사용 가능한 수가 읽혀집니다. 사용할 수 있는 데이터가 없으면 함수가 즉시 반환됩니다.

이 함수는 콘솔의 현재 코드 페이지에서 유니코드 문자 또는 8비트 문자를 사용합니다. 콘솔의 코드 페이지는 처음에 기본적으로 시스템의 OEM 코드 페이지로 설정됩니다. 콘솔의 코드 페이지를 변경하려면 SetConsoleCP 또는 SetConsoleOutputCP 함수를 사용합니다. 레거시 소비자는 chcp 또는 mode con cp select= 명령을 사용할 수도 있지만 새로운 개발에는 추천되지 않습니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	ConsoleApi.h(WinCon.h를 통해, Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll
유니코드 및 ANSI 이름	PeekConsoleInputW (유니코드) 및 PeekConsoleInputA (ANSI)