IUPnPDeviceFinderCallback::SearchComplete 메서드(upnp.h)
SearchComplete 메서드는 UPnP 프레임워크에서 호출되어 네트워크 디바이스에 대한 초기 검색이 완료되었음을 애플리케이션에 알립니다.
이 메서드는 UPnP 프레임워크가 검색을 시작할 때 네트워크에 있던 모든 디바이스에 대해 IUPnPDeviceFinderCallback::D eviceAdded 또는 IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface 콜백 전송을 완료했을 때 호출됩니다. 이러한 콜백은 검색이 시작된 시점의 네트워크 상태를 반영합니다.
구문
HRESULT SearchComplete(
[in] LONG lFindData
);
매개 변수
[in] lFindData
UPnP 프레임워크가 결과를 반환하는 검색을 지정합니다. lFindData 값은 IUPnPDeviceFinder::CreateAsyncFind에서 호출자에게 반환되는 값입니다.
반환 값
애플리케이션은 S_OK 반환해야 합니다.
설명
이 메서드는 단순히 정보를 제공합니다. 비동기 검색이 종료되었음을 나타내는 것이 아니라 초기 프로브가 완료되었음을 나타냅니다. 비동기 검색은 애플리케이션이 IUPnPDeviceFinder::CancelAsyncFind를 호출할 때까지 네트워크에서 추가되고 제거되는 디바이스를 보고합니다.
초기 검색을 완료하는 데 시간이 오래 걸릴 수 있습니다. SearchComplete 콜백은 마지막으로 발견된 디바이스에 대한 설명 문서(즉, 검색이 시작될 때 네트워크에 있는 것으로 확인된 마지막 디바이스)가 로드되었거나 로드되지 않을 때 호출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | upnp.h |
| DLL | Upnp.dll |