WSMAN_PLUGIN_SHELL fonction de rappel (wsman.h)

  • Article

Définit le rappel de l’interpréteur de commandes pour un plug-in. Cette fonction est appelée lorsqu’une demande pour un nouvel interpréteur de commandes est reçue. Tous les plug-ins de gestion à distance Windows qui prennent en charge les opérations d’interpréteur de commandes doivent implémenter ce rappel.

Le nom du point d’entrée dll doit être WSManPluginShell.

Syntaxe

WSMAN_PLUGIN_SHELL WsmanPluginShell;

void WsmanPluginShell(
  PVOID pluginContext,
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  WSMAN_SHELL_STARTUP_INFO *startupInfo,
  WSMAN_DATA *inboundShellInformation
)
{...}

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.

requestDetails

Pointeur vers une structure de WSMAN_PLUGIN_REQUEST qui spécifie l’URI de ressource, les options, les paramètres régionaux, l’indicateur d’arrêt et le handle pour la demande.

flags

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

startupInfo

Pointeur vers une structure de WSMAN_SHELL_STARTUP_INFO qui contient des informations de démarrage pour l’interpréteur de commandes.

inboundShellInformation

Pointeur vers une structure de WSMAN_DATA qui spécifie un objet entrant facultatif qui contient des données supplémentaires pour l’interpréteur de commandes.

Valeur de retour

None

Remarques

Le plug-in WinRM (WinRM) appelle WSManPluginReportContext pour inscrire un contexte d’interpréteur de commandes pour l’interpréteur de commandes. Toutes les opérations sur cet interpréteur de commandes passent dans ce contexte. Si l’interpréteur de commandes s’est arrêté ou si le plug-in vérifie le paramètre requestDetails et signale que l’opération a été annulée, le plug-in doit appeler WSManPluginOperationComplete. Tous les paramètres transmis sont valides jusqu’à ce que le plug-in WinRM appelle WSManPluginOperationComplete.

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, Windows Vista avec SP1 et Windows Vista avec SP2