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

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