IFunctionDiscoveryNotification::OnError 메서드(functiondiscoveryapi.h)

[함수 검색은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

비동기 쿼리를 처리하는 동안 발생하는 오류를 수신합니다.

구문

HRESULT OnError(
  [in] HRESULT        hr,
  [in] FDQUERYCONTEXT fdqcQueryContext,
  [in] const WCHAR    *pszProvider
);

[in] hr

보고되는 쿼리 오류입니다.

[in] fdqcQueryContext

변경 알림에 등록된 컨텍스트입니다. FDQUERYCONTEXT 형식은 DWORDLONG으로 정의됩니다.

[in] pszProvider

공급자의 이름입니다.

클라이언트 프로그램의 OnError 메서드 구현은 다음 HRESULT 값 중 하나를 호출자에게 반환해야 합니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_INVALIDARG	입력 매개 변수 중 하나의 값이 잘못되었습니다.

일반적으로 클라이언트는 비동기 오류가 치명적이고 쿼리가 결과 반환을 중지할 것으로 예상하지만 사용자 지정 공급자 설명서가 특정 오류 코드에 대해 달리 나타낼 수 있습니다.

이 메서드의 쿼리 개체에 대해 Release 를 호출하지 마세요. 이렇게 하면 교착 상태가 발생할 수 있습니다. 콜백이 진행되는 동안 다른 스레드의 쿼리 개체에서 Release 가 호출되면 콜백이 완료될 때까지 개체가 해제되지 않습니다.

공급자가 함수 검색에 전달한 모든 알림은 큐에 대기되고 클라이언트에 하나씩 반환됩니다. 콜백은 클라이언트가 한 번에 하나의 알림만 수신하도록 동기화됩니다.

다른 IFunctionDiscoveryNotification 메서드 호출은 다른 스레드에서 수행될 수 있으므로 메서드를 종료하기 전에 호출 중에 스레드 상태에 대한 모든 변경 내용을 복원해야 합니다.

이 페이지가 도움이 되었나요?