IWSDDeviceHost ::Start, méthode (wsdhost.h)

  • Article

Démarre l’hôte de l’appareil et publie l’hôte de l’appareil à l’aide d’un WS-Discovery message Hello. Si un récepteur de notifications est passé à cette méthode, le récepteur de notification est également inscrit. Une fois que l’option Démarrer a été appelée avec succès, l’hôte de l’appareil répond automatiquement aux messages Probe et Resolve.

Syntaxe

HRESULT Start(
  [in]           ULONGLONG            ullInstanceId,
  [in]           const WSD_URI_LIST   *pScopeList,
  [in, optional] IWSDDeviceHostNotify *pNotificationSink
);

Paramètres

[in] ullInstanceId

Identificateur de l'instance. Si aucun identificateur n’est fourni, la valeur instance actuelle + 1 est utilisée comme valeur par défaut.

Note Pour la compatibilité avec la spécification WS-Discovery, cette valeur doit être inférieure ou égale à UINT_MAX (4294967295).
 

[in] pScopeList

Étendue de l’hôte de l’appareil. Si la valeur est NULL, aucune étendue n’est associée à l’hôte.

[in, optional] pNotificationSink

Référence à un objet IWSDDeviceHostNotify qui spécifie le récepteur de notification.

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.
S_FALSE
 L’hôte de l’appareil a déjà été démarré.
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.
E_ABORT
 Aucune métadonnées n’est associée à l’hôte.

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