IUpdateSession3::QueryHistory 메서드(wuapi.h)

컴퓨터에서 업데이트 이벤트의 기록을 동기적으로 쿼리합니다. 이 메서드는 컴퓨터에서 일치하는 이벤트 레코드를 포함하는 IUpdateHistoryEntryCollection 인터페이스에 대한 포인터를 반환합니다.

구문

HRESULT QueryHistory(
  [in]  BSTR                          criteria,
  [in]  LONG                          startIndex,
  [in]  LONG                          count,
  [out] IUpdateHistoryEntryCollection **retval
);

매개 변수

[in] criteria

검색 조건을 지정하는 문자열입니다.

[in] startIndex

검색할 첫 번째 이벤트의 인덱스입니다.

[in] count

검색할 이벤트 수입니다.

[out] retval

컴퓨터에서 일치하는 이벤트 레코드를 내림차순으로 포함하는 IUpdateHistoryEntryCollection 인터페이스에 대한 포인터입니다.

반환 값

성공하면 S_OK 반환합니다. 그렇지 않으면 COM 또는 Windows 오류 코드를 반환합니다.

이 메서드는 다음 오류 코드를 반환할 수도 있습니다.

반환 코드	설명
E_POINTER	매개 변수 값이 잘못되었거나 NULL입니다.
WU_E_INVALID_CRITERIA	잘못된 검색 조건이 있습니다.

설명

반환되는 이벤트 컬렉션은 날짜를 기준으로 내림차순으로 정렬됩니다.

criteria 매개 변수에 사용되는 문자열은 QueryHistory에 대한 사용자 지정 검색 언어와 일치해야 합니다. 문자열에는 반환할 기록 이벤트를 결정하기 위해 평가되는 조건이 포함되어 있습니다.

QueryHistory는 컴퓨터별 업데이트만 지원합니다.

검색 조건 구문에 대한 전체 설명은 검색을 참조 하세요.

다음 표에서는 모든 공용 지원 조건을 평가 우선 순위순으로 식별합니다. 나중에 이 목록에 더 많은 조건을 추가할 수 있습니다.

조건	형식	허용되는 연산자	Description
UpdateID	string(UUID)	=	지정된 값의 UpdateIdentity.UpdateID 가 있는 업데이트를 찾습니다. 예를 들어 "UpdateID='12345678-9abc-def0-1234-56789abcdef0'은 12345678-9abc-def0-1234-56789abcdef0과 같은 UpdateIdentity.UpdateID 에 대한 업데이트를 찾습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional SP3 포함 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wuapi.h
라이브러리	Wuguid.lib
DLL	Wuapi.dll

추가 정보

IUpdateSession3