Compartilhar via

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

  • Artigo

Inicializa uma pesquisa por hosts WS-Discovery por tipo de dispositivo.

Sintaxe

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

Parâmetros

[in, optional] pTypesList

Ponteiro para uma estrutura de WSD_NAME_LIST que representa a lista de tipos de provedor de descoberta a serem pesquisados. Pode ser NULL.

[in, optional] pScopesList

Ponteiro para uma estrutura WSD_URI_LIST que representa a lista de escopos do provedor de descoberta a serem pesquisados. Pode ser NULL.

[in, optional] pszMatchBy

Regra de correspondência usada para escopos. Pode ser NULL.

[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
 O comprimento em caracteres de pszMatchBy 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

SearchByType inicia uma investigação de WS-Discovery na tentativa de localizar hosts de descoberta que correspondam aos critérios fornecidos. Esse método permite a correspondência por tipos, escopos, alguma combinação dos dois ou correspondência de todos os dispositivos capazes de descoberta (quando nenhum escopo ou tipos são fornecidos).

pszMatchBy deverá ser fornecido se e somente se pScopesList também for fornecido. 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.

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