Compartilhar via


Método IWSDiscoveryProvider::SearchByAddress (wsddisco.h)

Inicializa uma pesquisa para hosts WS-Discovery por endereço do dispositivo.

Sintaxe

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

Parâmetros

[in] pszAddress

O endereço de transporte HTTP do dispositivo.

[in, optional] pszTag

Marca de identificador opcional para esta pesquisa. Pode ser NULL.

Retornar valor

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte:

Código de retorno Descrição
S_OK
Método concluído com êxito.
E_INVALIDARG
pszAddress é NULL, o comprimento em caracteres de pszAddress 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

SearchByAddress inicia uma investigação de WS-Discovery por HTTP na tentativa de identificar um dispositivo em uma URL conhecida. A Investigação é enviada para o endereço especificado por pszAddress. Essa chamada pode resultar em um ou mais retornos de chamada adicionais . Se algum retorno de chamada Adicionar 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. O intervalo entre iniciar a pesquisa e receber uma dessas notificações pode ser de até 30 segundos.

pszTag é uma cadeia de caracteres opcional fornecida pelo usuário que será alimentada novamente 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

Requisito Valor
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 (inclua Wsdapi.h)
DLL Wsdapi.dll

Confira também

Iwsdiscoveryprovider