WSMAN_PLUGIN_SHUTDOWN fonction de rappel (wsman.h)

  • Article

Définit le rappel d’arrêt pour le plug-in. Cette fonction est appelée après que toutes les opérations ont été annulées et avant que la DLL du plug-in de gestion à distance Windows soit déchargée. Tous les plug-ins WinRM doivent implémenter cette fonction de rappel.

Le nom du point d’entrée de LA DLL doit être WSManPluginShutdown.

Syntaxe

WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;

DWORD WsmanPluginShutdown(
  PVOID pluginContext,
  DWORD flags,
  DWORD reason
)
{...}

Paramètres

pluginContext

Spécifie le contexte retourné par un appel à la méthode WSManPluginStartup . Ce paramètre représente une initialisation d’application spécifique d’un plug-in WinRM. Le point d’entrée d’arrêt est appelé pour chaque application qui l’a initialisé.

flags

Réservé pour un usage futur. Doit être défini sur zéro.

reason

Spécifie la raison pour laquelle le plug-in s’arrête.

WSMAN_PLUGIN_SHUTDOWN_SYSTEM

Le système s’arrête.

WSMAN_PLUGIN_SHUTDOWN_SERVICE

Le service WinRM s’est arrêté.

WSMAN_PLUGIN_SHUTDOWN_IISHOST

L’hôte IIS s’est arrêté.

Valeur retournée

La méthode retourne NO_ERROR si elle a réussi ; sinon, elle retourne un code d’erreur.

Note Si cette méthode échoue, le plug-in ne rappelle pas.
 

Remarques

Chaque appel réussi à WSManPluginStartup entraîne un appel à cette fonction avant que la DLL du plug-in WinRM ne soit déchargée. Il est important de s’assurer que le plug-in WinRM suit le nombre de fois où ce point d’entrée de démarrage est appelé afin que le plug-in ne s’arrête pas prématurément.

Cette fonction doit s’assurer que tous les threads de plug-in sont arrêtés avant de revenir. Si le plug-in gère uniquement les opérations synchrones et que tous les threads signalent un résultat d’annulation avant leur retour, cette fonction effectue uniquement le nettoyage du plug-in. Toutefois, pour un plug-in asynchrone, tous les threads utilisés pour traiter les threads de plug-in, y compris ceux qui viennent de signaler l’annulation pour toutes les opérations, doivent être complètement arrêtés. Si tous les threads ne sont pas arrêtés, des incidents dans la DLL peuvent se produire, car le code peut être exécuté après le déchargement de la DLL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7
Serveur minimal pris en charge Windows Server 2008 R2
Plateforme cible Windows
En-tête wsman.h
Composant redistribuable Windows Management Framework sur Windows Server 2008 avec SP2, et Windows Vista avec SP2