Método IUPnPDeviceFinderCallback::SearchComplete (upnp.h)

O método SearchComplete é invocado pela estrutura UPnP para notificar o aplicativo de que a pesquisa inicial para dispositivos de rede foi concluída.

Esse método é invocado quando a estrutura UPnP termina de enviar retornos de chamada IUPnPDeviceFinderCallback::D eviceAdded ou IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface para todos os dispositivos presentes na rede no momento em que a pesquisa foi iniciada. Esses retornos de chamada refletem o estado da rede no momento em que a pesquisa foi iniciada.

Sintaxe

HRESULT SearchComplete(
  [in] LONG lFindData
);

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.

Retornar valor

O aplicativo deve retornar S_OK.

Comentários

Esse método simplesmente fornece informações. Ele não indica que a pesquisa assíncrona terminou, mas sim que a investigação inicial foi concluída. A pesquisa assíncrona continua relatando dispositivos sendo adicionados e removidos da rede até que o aplicativo chame IUPnPDeviceFinder::CancelAsyncFind.

A pesquisa inicial pode levar muito tempo para ser concluída. O retorno de chamada SearchComplete é invocado quando o documento de descrição do último dispositivo encontrado (ou seja, o último dispositivo encontrado na rede no momento em que a pesquisa foi iniciada) foi carregado ou não foi carregado.

Requisitos

Confira também

Iupnpdevicefinder

IUPnPDeviceFinder::CreateAsyncFind

IUPnPDeviceFinderCallback