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

Article
03/04/2024

Initialise une recherche d’hôtes WS-Discovery par adresse d’appareil.

Syntaxe

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

Paramètres

[in] pszAddress

Adresse de transport HTTP de l’appareil.

[in, optional] pszTag

Balise d’identificateur facultative pour cette recherche. Peut être NULL.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants :

Code de retour	Description
S_OK	Méthode terminée avec succès.
E_INVALIDARG	pszAddress a la valeur NULL, la longueur en caractères de pszAddress dépasse WSD_MAX_TEXT_LENGTH (8192), ou la longueur en caractères de pszTag dépasse WSD_MAX_TEXT_LENGTH (8192).
E_ABORT	Aucune interface de rappel n’a été attachée. Vous devez appeler Attach avant d’appeler cette méthode.
E_OUTOFMEMORY	Il n’existe pas suffisamment de mémoire pour effectuer l’opération.

Remarques

SearchByAddress lance une sonde WS-Discovery via HTTP pour tenter d’identifier un appareil à une URL connue. La sonde est envoyée à l’adresse spécifiée par pszAddress. Cet appel peut entraîner un ou plusieurs rappels d’ajout . Si des rappels d’ajout sont émis avant la fin de la recherche, un rappel SearchComplete est émis ; dans le cas contraire, un rappel SearchFailed sera émis. L’intervalle entre le lancement de la recherche et la réception de l’une de ces notifications peut atteindre 30 secondes.

pszTag est une chaîne facultative fournie par l’utilisateur qui sera réinsérée dans l’un des rappels, ce qui permet à l’appelant d’associer le rappel à la requête d’origine.

Pour plus d’informations sur la résolution des problèmes d’applications appelant cette méthode, consultez Résolution des problèmes d’applications WSDAPI.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsddisco.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDiscoveryProvider

Partager via