Partager via

Méthode IWSDDeviceHost ::RetireService (wsdhost.h)

  • Article

Annule l’inscription d’un objet de service qui a été inscrit à l’aide de RegisterService et supprime le service des métadonnées de l’hôte de l’appareil.

Syntaxe

HRESULT RetireService(
  [in] LPCWSTR pszServiceId
);

Paramètres

[in] pszServiceId

ID du service à supprimer.

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_POINTER
 pszServiceId a la valeur NULL.
E_INVALIDARG
 La longueur en caractères de pszServiceId dépasse WSD_MAX_TEXT_LENGTH (8192), ou pszServiceId est introuvable dans la liste des services inscrits.
E_FAIL
 Échec de la méthode. Elle a peut-être échoué, car l’hôte n’a pas été initialisé. Appelez Init pour initialiser un hôte d’appareil.

Remarques

L’hôte de l’appareil libère sa référence à l’objet de service une fois le service désinscrit. L’objet de service ne recevra pas de rappels une fois RetireService terminé.

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 wsdhost.h (inclure Wsdapi.h)
DLL Wsdapi.dll

Voir aussi

IWSDDeviceHost