GetConsoleProcessList 함수

  • 아티클

현재 콘솔에 연결된 프로세스 목록을 검색합니다.

구문

DWORD WINAPI GetConsoleProcessList(
  _Out_ LPDWORD lpdwProcessList,
  _In_  DWORD   dwProcessCount
);

매개 변수

lpdwProcessList [out]
성공 시 프로세스 식별자 배열을 수신하는 버퍼에 대한 포인터입니다. 이 버퍼는 유효한 버퍼여야 하며 을(를) 사용할 NULL수 없습니다. 버퍼에는 적어도 1개 이상의 반환된 프로세스 ID를 받을 공간이 있어야 합니다.

dwProcessCount [in]
lpdwProcessList 버퍼에 저장할 수 있는 최대 프로세스 식별자 수입니다. 0보다 커야 합니다.

반환 값

함수가 성공하면 반환 값이 dwProcessCount보다 작거나 같으며 lpdwProcessList 버퍼에 저장된 프로세스 식별자 수를 나타냅니다.

버퍼가 너무 작아서 모든 유효한 프로세스 식별자를 보유하지 못하면 반환 값은 필요한 배열 요소 수입니다. 함수는 버퍼에 식별자를 저장하지 않습니다. 이 경우 반환 값을 사용하여 전체 목록을 저장하고 함수를 다시 호출할 수 있을 만큼 큰 버퍼를 할당합니다.

반환 값이 0이면 모든 콘솔에 연결된 프로세스가 하나 이상 있으므로 함수가 실패했습니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

NULL 프로세스 목록이 제공되었거나 프로세스 수가 0이면 호출은 0을 반환하고 GetLastError 반환ERROR_INVALID_PARAMETER합니다. 이 함수를 호출할 하나 이상의 요소 버퍼를 제공하세요. 더 큰 버퍼를 할당하고 반환 코드가 제공된 버퍼의 길이보다 큰 경우 다시 호출합니다.

설명

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0501 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조 하세요.

팁

이 API는 권장되지 않으며 해당하는 가상 터미널이 없습니다. 이 결정은 의도적으로 Windows 플랫폼을 다른 운영 체제와 정렬합니다. 이 상태는 로컬 사용자, 세션 및 권한 컨텍스트와만 관련이 있습니다. 이 API를 사용하는 경우 플랫폼 간 유틸리티 및 SSH와 같은 전송을 통한 애플리케이션 원격 작업이 예상대로 작동하지 않을 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003[데스크톱 앱만 해당]
헤더 ConsoleApi3.h(WinCon.h를 통해 Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

AttachConsole

콘솔 함수