IWSDiscoveryProviderNotify::SearchFailed 메서드(wsddisco.h)
사용자가 시작한 검색이 실패했음을 나타내기 위해 호출됩니다.
구문
HRESULT SearchFailed(
[in] HRESULT hr,
[in, optional] LPCWSTR pszTag
);
매개 변수
[in] hr
이 콜백을 시작한 검색 실패의 원인입니다. S_FALSE 값은 추가 콜백을 실행하지 않고 검색이 완료되었음을 나타냅니다.
[in, optional] pszTag
이 검색에 대한 선택적 식별자 태그입니다. NULL일 수 있습니다.
반환 값
반환 값은 의미가 없습니다. 구현자는 S_OK 반환해야 합니다.
설명
응답이 성공적으로 수신된 경우 SearchComplete가 호출됩니다.
사용자가 시작한 쿼리가 응답을 생성하지 않으면 SearchFailed가 호출됩니다. 이 경우 hr 매개 변수의 값은 S_FALSE. 쿼리 전송이 반드시 동기적인 것은 아니기 때문에 쿼리 전송 시도 시 오류가 발생하는 경우 SearchFailed를 선택적으로 호출할 수 있습니다. pszTag 는 쿼리에서 사용자가 제공한 태그와 일치하며 실패한 쿼리를 식별하는 데 사용해야 합니다.
SearchByType 또는 SearchById를 사용하여 검색을 시작하고 SearchFailed 알림을 받는 간격은 WS-Discovery의 MATCH_TIMEOUT 따라 DPWS 부록 I에 의해 수정된 최대 10초입니다. SearchByAddress를 사용하여 검색을 시작하고 SearchFailed 알림을 받는 간격은 일반적으로 21초이지만 최대 150초가 될 수 있습니다.
참고 공급자가 SearchFailed 를 여러 차례 동시에 호출할 수 있으므로 이 콜백에서 공유 데이터를 동기화해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wsddisco.h(Wsdapi.h 포함) |
| DLL | Wsdapi.dll |