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 |
|---|---|
|
El método se completó correctamente. |
|
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). |
|
No se ha asociado una interfaz de devolución de llamada. Debe llamar a Attach antes de llamar a este método. |
|
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 |