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
S_OK	Método concluído com êxito.
E_INVALIDARG	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).
E_ABORT	Uma interface de retorno de chamada não foi anexada. Você deve chamar Attach antes de chamar esse método.
E_OUTOFMEMORY	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

Confira também

Iwsdiscoveryprovider