IWSDiscoveryProvider ::SearchByType, méthode (wsddisco.h)

Article
03/04/2024

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

Syntaxe

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

Paramètres

[in, optional] pTypesList

Pointeur vers une structure WSD_NAME_LIST qui représente la liste des types de fournisseurs de découverte à rechercher. Peut être NULL.

[in, optional] pScopesList

Pointeur vers une structure WSD_URI_LIST qui représente la liste des étendues de fournisseur de découverte à rechercher. Peut être NULL.

[in, optional] pszMatchBy

Règle de correspondance utilisée pour les étendues. Peut être NULL.

[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	La méthode s’est terminée avec succès.
E_INVALIDARG	La longueur en caractères de pszMatchBy 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	La mémoire est insuffisante pour effectuer l’opération.

Remarques

SearchByType lance une sonde WS-Discovery pour tenter de localiser les hôtes de découverte correspondant aux critères fournis. Cette méthode permet la mise en correspondance par types, étendues, une combinaison des deux ou la correspondance de tous les appareils compatibles avec la découverte (quand aucune étendue ou type n’est fournie).

pszMatchBy doit être fourni si et uniquement si pScopesList est également fourni. 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 ; sinon, un rappel SearchFailed est émis.

pszTag est une chaîne facultative fournie par l’utilisateur qui sera renvoyée dans l’un ou l’autre rappel, 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 liés aux applications appelant cette méthode, consultez Résolution des problèmes liés aux 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