Méthode IWSDiscoveryPublisher::UnPublish (wsddisco.h)

Article
08/28/2023

Annonce le départ d’un hôte réseau en envoyant un message Bye .

Syntaxe

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

Paramètres

[in] pszId

Adresse logique ou physique de l’appareil, qui est utilisée comme adresse de point de terminaison de l’appareil. Une adresse logique est de la forme urn:uuid:{guid}. Une adresse physique peut être un URI préfixé par http ou https, ou simplement un URI préfixé par uri. Dans la mesure du possible, utilisez une adresse logique.

[in] ullInstanceId

Identificateur de la instance actuelle de l’appareil en cours de publication. Cet identificateur doit être incrémenté chaque fois que le service est redémarré. Pour plus d’informations sur les identificateurs instance, consultez l’Annexe I de la spécification WS-Discovery.

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

[in] ullMessageNumber

Compteur dans l’étendue de l’identificateur de instance pour le message actuel. Le numéro de message doit être incrémenté pour chaque message.

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

[in, optional] pszSessionId

Identificateur unique dans l’étendue de l’identificateur de instance pour la session active. Ce paramètre correspond à l’identificateur de séquence dans le bloc AppSequence dans le message Probe. Pour plus d’informations sur les identificateurs de séquence, consultez l’Annexe I de la spécification WS-Discovery.

Ce paramètre peut être NULL.

[in, optional] pAny

Pointeur vers une structure WSDXML_ELEMENT qui contient un élément XML à insérer dans la section « ANY » du corps du message.

Valeur retournée

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

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_INVALIDARG	Une ou plusieurs des conditions suivantes sont remplies : pszId a la valeur NULL. La longueur du pszId dépasse WSD_MAX_TEXT_LENGTH (8192). La longueur de pszSessionId dépasse WSD_MAX_TEXT_LENGTH (8192).
E_ABORT	L’éditeur n’a pas été démarré. L’attachement d’un récepteur de notification démarre le serveur de publication. Pour attacher un récepteur, appelez RegisterNotificationSink.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.

Remarques

En cas de réussite, annuler la publication envoie un message WS-Discovery Bye au sous-réseau local avec les informations fournies.

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

IWSDiscoveryPublisher

Partager via