Compartilhar via


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