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

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

Sintaxis

HRESULT SearchById(
  [in]           LPCWSTR pszId,
  [in, optional] LPCWSTR pszTag
);

Parámetros

[in] pszId

Identificador de dispositivo del proveedor de detección deseado.

[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	pszId es NULL, la longitud en caracteres de pszId 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.

Observaciones

SearchById inicia una WS-Discovery Resolver en un intento de localizar un dispositivo específico conocido anteriormente. pszId se usa como dirección del punto de conexión en Resolve. 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

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