Método IWSDiscoveryProvider::SearchById (wsddisco.h)
Inicializa uma pesquisa de hosts WS-Discovery por identificador de dispositivo.
Sintaxe
HRESULT SearchById(
[in] LPCWSTR pszId,
[in, optional] LPCWSTR pszTag
);
Parâmetros
[in] pszId
Identificador de dispositivo do provedor de descoberta desejado.
[in, optional] pszTag
Marca de identificador opcional para esta pesquisa. Pode ser NULL.
Valor retornado
Os valores retornados possíveis incluem, mas não se limitam a:
| Código de retorno | Descrição |
|---|---|
|
Método concluído com êxito. |
|
pszId é NULL, o comprimento em caracteres de pszId excede WSD_MAX_TEXT_LENGTH (8192) ou o comprimento em caracteres de pszTag excede WSD_MAX_TEXT_LENGTH (8192). |
|
Uma interface de retorno de chamada não foi anexada. Você deve chamar Attach antes de chamar esse método. |
|
Não existe memória suficiente para executar a operação. |
Comentários
SearchById inicia um WS-Discovery Resolver na tentativa de localizar um dispositivo específico conhecido anteriormente. pszId é usado como o endereço do ponto de extremidade na resolução. Essa chamada pode resultar em um ou mais retornos de chamada de Adição . Se algum Adicionar retornos de chamada for emitido antes da conclusão da pesquisa, um retorno de chamada SearchComplete será emitido; caso contrário, um retorno de chamada SearchFailed será emitido.
pszTag é uma cadeia de caracteres opcional fornecida pelo usuário que será retornada em qualquer retorno de chamada, permitindo que o chamador associe o retorno de chamada à consulta original.
Para obter informações sobre como solucionar problemas de aplicativos que chamam esse método, consulte Solução de problemas de aplicativos WSDAPI.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wsddisco.h (include Wsdapi.h) |
| DLL | Wsdapi.dll |