Método IUPnPDeviceFinderCallback::D eviceAdded (upnp.h)

O método DeviceAdded é invocado pela estrutura UPnP para notificar o aplicativo de que um dispositivo foi adicionado à rede.

Sintaxe

HRESULT DeviceAdded(
  [in] LONG        lFindData,
  [in] IUPnPDevice *pDevice
);

Parâmetros

[in] lFindData

Especifica a pesquisa para a qual a estrutura UPnP está retornando resultados. O valor de lFindData é o valor retornado ao chamador por IUPnPDeviceFinder::CreateAsyncFind.

[in] pDevice

Referência a um objeto IUPnPDevice que contém o novo dispositivo.

Retornar valor

A estrutura UPnP não espera que o aplicativo retorne nenhum valor específico; qualquer valor retornado é ignorado pela estrutura UPnP.

Comentários

A estrutura UPnP pode chamar o método IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface em vez de DeviceAdded para notificar o aplicativo quando um dispositivo é adicionado à rede. A estrutura UPnP consultará para ver se a interface IUPnPDeviceFinderAddCallbackWithInterface existe. Nesse caso, a estrutura UPnP chamará DeviceAddedWithInterface. Caso contrário, a estrutura UPnP chamará DeviceAdded.

A estrutura UPnP pode retornar dois ou mais retornos de chamada para o mesmo dispositivo. Isso pode acontecer se o endereço IP de um dispositivo foi alterado sem primeiro remover o dispositivo e, em seguida, adicioná-lo novamente à rede. Se isso ocorrer, um aplicativo deverá descartar o dispositivo antigo e usar o retornado mais recentemente. Um aplicativo verifica se há dispositivos duplicados comparando as UDNs.

Requisitos

Confira também

Iupnpdevicefinder

IUPnPDeviceFinder::CreateAsyncFind

IUPnPDeviceFinderCallback