다음을 통해 공유

PssWalkSnapshot 함수(processsnapshot.h)

  • 아티클

현재 워크 위치에서 정보를 반환하고 워크 마커를 다음 위치로 진행합니다.

구문

DWORD PssWalkSnapshot(
  [in]  HPSS                       SnapshotHandle,
  [in]  PSS_WALK_INFORMATION_CLASS InformationClass,
  [in]  HPSSWALK                   WalkMarkerHandle,
  [out] void                       *Buffer,
  [in]  DWORD                      BufferLength
);

매개 변수

[in] SnapshotHandle

스냅샷 대한 핸들입니다.

[in] InformationClass

반환할 정보의 형식입니다. 자세한 내용은 PSS_WALK_INFORMATION_CLASS 참조하세요.

[in] WalkMarkerHandle

워크 마커에 대한 핸들입니다. 워크 마커는 데이터를 반환할 도보 위치를 나타냅니다. PssWalkSnapshot 은 호출자에게 반환하기 전에 워크 마커를 시간 순서대로 다음 워크 위치로 이동합니다.

[out] Buffer

이 함수가 반환하는 스냅샷 정보입니다.

[in] BufferLength

버퍼의 크기(바이트)입니다.

반환 값

이 함수는 성공 또는 다음 오류 코드 중 하나에 대한 ERROR_SUCCESS 반환합니다.

반환 코드 설명
ERROR_BAD_LENGTH
 지정된 버퍼 길이가 잘못되었습니다.
ERROR_INVALID_HANDLE
 지정한 핸들이 잘못되었습니다.
ERROR_INVALID_PARAMETER
 지정한 정보 클래스가 잘못되었습니다.
ERROR_MORE_DATA
 버퍼 는 NULL이며 반환할 현재 위치에 데이터가 있습니다.
ERROR_NO_MORE_ITEMS
 걷기가 완료되었으며 반환할 항목이 더 이상 없습니다.
ERROR_NOT_FOUND
 요청된 정보가 스냅샷 없습니다.
 

모든 오류 코드는 winerror.h에 정의되어 있습니다. FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 FormatMessage를 사용하여 오류 코드에 대한 메시지를 가져옵니다.

설명

스냅샷 내의 인스턴스 수가 가변적인 스냅샷 데이터 형식의 경우 PssWalkSnapshot 함수를 사용하여 인스턴스를 하나씩 가져옵니다. InformationClass 매개 변수를 설정하여 데이터 형식을 지정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 R2 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 processsnapshot.h
DLL Kernel32.dll

참고 항목

프로세스 스냅샷