Método IUPnPDeviceFinder::FindByType (upnp.h)
O método FindByType pesquisa de forma síncrona dispositivos por tipo de dispositivo ou tipo de serviço.
Sintaxe
HRESULT FindByType(
[in] BSTR bstrTypeURI,
[in] DWORD dwFlags,
[out] IUPnPDevices **pDevices
);
Parâmetros
[in] bstrTypeURI
Especifica o URI de tipo para o tipo de dispositivo ou serviço para o qual pesquisar.
[in] dwFlags
Deve ser zero. Esse parâmetro é reservado para uso futuro.
[out] pDevices
Recebe uma referência a uma coleção de dispositivos IUPnPDevices que foram encontrados.
Valor retornado
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.
Comentários
Esse método não retorna até que a pesquisa seja concluída. A pesquisa pode levar pelo menos nove segundos e, possivelmente, mais. Esse método não deve ser chamado de um thread que processa mensagens de interface do usuário.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnp.h |
| DLL | Upnp.dll |