Compartir a través de

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

  • Artículo

Inicializa una búsqueda de hosts de WS-Discovery por tipo de dispositivo.

Sintaxis

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

Puntero a una estructura de WSD_NAME_LIST que representa la lista de tipos de proveedor de detección que se van a buscar. Puede ser NULL.

[in, optional] pScopesList

Puntero a una estructura de WSD_URI_LIST que representa la lista de ámbitos del proveedor de detección que se van a buscar. Puede ser NULL.

[in, optional] pszMatchBy

Regla de coincidencia usada para ámbitos. Puede ser NULL.

[in, optional] pszTag

Etiqueta de identificador opcional para esta búsqueda. Puede ser NULL.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes:

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_INVALIDARG
 La longitud en caracteres de pszMatchBy supera WSD_MAX_TEXT_LENGTH (8192) o la longitud en caracteres de pszTag supera WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 No se ha asociado una interfaz de devolución de llamada. Debe llamar a Attach antes de llamar a este método.
E_OUTOFMEMORY
 No existe suficiente memoria para realizar la operación.

Comentarios

SearchByType inicia un sondeo de WS-Discovery en un intento de buscar hosts de detección que coincidan con los criterios proporcionados. Este método permite la coincidencia por tipos, ámbitos, alguna combinación de los dos o la coincidencia de todos los dispositivos compatibles con detección (cuando no se proporcionan ámbitos o tipos).

se debe proporcionar pszMatchBy si y solo si también se proporciona pScopesList. Esta llamada puede dar lugar a una o varias devoluciones de llamada Add . Si se emite alguna devolución de llamada Agregar antes de que se complete la búsqueda, se emitirá una devolución de llamada searchComplete ; de lo contrario, se emitirá una devolución de llamada SearchFailed .

pszTag es una cadena opcional proporcionada por el usuario que se devolverá en cualquier devolución de llamada, lo que permite al autor de la llamada asociar la devolución de llamada a la consulta original.

Para obtener información sobre cómo solucionar problemas de aplicaciones que llaman a este método, consulte Solución de problemas de aplicaciones WSDAPI.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdisco.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDiscoveryProvider