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

Article
08/28/2023

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

Syntaxe

HRESULT SearchById(
  [in]           LPCWSTR pszId,
  [in, optional] LPCWSTR pszTag
);

Paramètres

[in] pszId

Identificateur d’appareil du fournisseur de découverte souhaité.

[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	pszId a la valeur NULL, la longueur en caractères de pszId 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

SearchById lance une WS-Discovery résoudre dans une tentative de localisation d’un appareil spécifique connu précédemment. pszId est utilisé comme adresse de point de terminaison dans résoudre. 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.

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.

Spécifications


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