IUpdateSearcher::BeginSearch 메서드(wuapi.h)

업데이트에 대한 비동기 검색 실행을 시작합니다. 검색은 현재 구성된 검색 옵션을 사용합니다.

구문

HRESULT BeginSearch(
  [in]  BSTR       criteria,
  [in]  IUnknown   *onCompleted,
  [in]  VARIANT    state,
  [out] ISearchJob **retval
);

[in] criteria

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

[in] onCompleted

비동기 검색 작업이 완료될 때 호출되는 ISearchCompletedCallback 인터페이스입니다.

[in] state

ISearchJob 인터페이스의 AsyncState 속성에서 반환되는 호출자별 상태입니다.

[out] retval

보류 중일 수 있는 현재 작업을 나타내는 ISearchJob 인터페이스입니다.

호출자는 반환된 값을 EndSearch 메서드에 전달하여 검색 작업을 완료합니다.

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

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

반환 코드	설명
E_POINTER	매개 변수 값이 잘못되었거나 NULL입니다.
E_ACCESSDENIED	이 메서드는 원격 컴퓨터에서 호출할 수 없습니다.

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

ISearchCompletedCallback 인터페이스를 구현하는 대신 스크립트를 사용하여 자동화 개체에서 DISPID 0이 있는 식별자의 콜백 루틴을 구현할 수 있습니다. onCompleted 매개 변수의 형식은 IUnknown*입니다.

앱에서 비동기 WUA API를 사용하는 경우 시간 제한 메커니즘을 구현해야 할 수 있습니다. 비동기 WUA 작업을 수행하는 방법에 대한 자세한 내용은 비동기 WUA 작업에 대한 지침을 참조하세요.

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