IUPnPDeviceFinderCallback::D eviceAdded 메서드(upnp.h)
DeviceAdded 메서드는 UPnP 프레임워크에서 호출되어 디바이스가 네트워크에 추가되었음을 애플리케이션에 알립니다.
구문
HRESULT DeviceAdded(
[in] LONG lFindData,
[in] IUPnPDevice *pDevice
);
매개 변수
[in] lFindData
UPnP 프레임워크가 결과를 반환하는 검색을 지정합니다. lFindData 값은 IUPnPDeviceFinder::CreateAsyncFind에서 호출자에게 반환되는 값입니다.
[in] pDevice
새 디바이스를 포함하는 IUPnPDevice 개체에 대한 참조입니다.
반환 값
UPnP 프레임워크는 애플리케이션이 특정 값을 반환할 것으로 예상하지 않습니다. 반환된 모든 값은 UPnP 프레임워크에서 무시됩니다.
설명
UPnP 프레임워크는 디바이스가 네트워크에 추가될 때 애플리케이션에 알리기 위해 DeviceAdded 대신 IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface 메서드를 호출할 수 있습니다. UPnP 프레임워크는 IUPnPDeviceFinderAddCallbackWithInterface 인터페이스가 있는지 확인하기 위해 쿼리합니다. 이 경우 UPnP 프레임워크는 DeviceAddedWithInterface를 호출합니다. 그렇지 않으면 UPnP 프레임워크는 DeviceAdded를 호출합니다.
UPnP 프레임워크는 동일한 디바이스에 대해 둘 이상의 콜백을 반환할 수 있습니다. 이 문제는 디바이스를 먼저 제거한 다음 네트워크에 다시 추가하지 않고 디바이스의 IP 주소를 변경한 경우에 발생할 수 있습니다. 이 경우 애플리케이션은 이전 디바이스를 삭제하고 가장 최근에 반환된 디바이스를 사용해야 합니다. 애플리케이션은 UDF를 비교하여 중복된 디바이스를 확인합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | upnp.h |
| DLL | Upnp.dll |