IVdsService::Unadvise, méthode (vds.h)

Article
03/08/2023

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]

Annule l’inscription de l’interface IVdsAdviseSink de l’appelant afin que l’appelant ne reçoive plus de notifications du service VDS.

Syntaxe

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Paramètres

[in] dwCookie

Cookie retourné par la méthode IVdsService::Advise lors de l’inscription de l’interface IVdsAdviseSink .

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code/valeur de retour	Description
S_OK	La commande s'est correctement terminée.
VDS_E_BAD_COOKIE 0x80042411L	Le cookie n’existe pas.
VDS_E_INITIALIZED_FAILED 0x80042401L	Échec de l’initialisation de VDS. Si une application appelle cette méthode avant la fin de l’initialisation du service, la méthode est bloquée jusqu’à la fin de l’initialisation. Si l’initialisation échoue, cette erreur est retournée.

Remarques

Utilisez la méthode Advise pour inscrire l’interface IVdsAdviseSink de votre application VDS afin de recevoir des notifications de VDS. Advise retourne un cookie que vous devez renvoyer en tant que paramètre à la méthode Unadvise .

Note Une application qui appelle Advise doit éventuellement appeler Unadvise. Dans l’idéal, il doit appeler Unadvise dès qu’il n’a plus besoin de recevoir de notifications.

La méthode Unadvise peut ne pas revenir immédiatement, car elle attend qu’un verrou met à jour la liste des applications clientes inscrites et attend que le thread de notification envoyant les notifications clientes se termine. S’il y a des notifications en attente à envoyer à votre application, le thread de notification tente de les envoyer avant de quitter.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vds.h
Bibliothèque	Uuid.lib

Voir aussi

Partager via