Compartir a través de

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

  • Artículo

Inicializa una búsqueda de hosts WS-Discovery por dirección del dispositivo.

Sintaxis

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

Parámetros

[in] pszAddress

Dirección de transporte HTTP del dispositivo.

[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
 pszAddress es NULL, la longitud en caracteres de pszAddress supera WSD_MAX_TEXT_LENGTH (8192) o la longitud en caracteres de pszTag supera WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 No se ha adjuntado 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

SearchByAddress inicia un sondeo de WS-Discovery a través de HTTP en un intento de identificar un dispositivo en una dirección URL conocida. El sondeo se envía a la dirección especificada por pszAddress. Esta llamada puede dar lugar a una o varias devoluciones de llamada Add . Si se emite alguna devolución de llamada Add 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 . El intervalo entre iniciar la búsqueda y recibir cualquiera de estas notificaciones puede ser de hasta 30 segundos.

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 wsddisco.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDiscoveryProvider