Partager via


WSMAN_PLUGIN_COMMAND fonction de rappel (wsman.h)

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

Le nom du point d’entrée de la DLL doit être WSManPluginCommand.

Syntaxe

WSMAN_PLUGIN_COMMAND WsmanPluginCommand;

void WsmanPluginCommand(
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  PVOID shellContext,
  PCWSTR commandLine,
  WSMAN_COMMAND_ARG_SET *arguments
)
{...}

Paramètres

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.

shellContext

Spécifie le contexte retourné par la création de l’interpréteur de commandes auquel cette commande doit être associée.

commandLine

Spécifie la ligne de commande à exécuter.

arguments

Pointeur vers une structure WSMAN_COMMAND_ARG_SET qui spécifie les arguments de ligne de commande à passer à la commande.

Valeur de retour

None

Remarques

Le plug-in WinRM (WinRM) appelle la méthode WSManPluginReportContext pour inscrire un contexte de commande pour la commande. Toutes les opérations de cette commande sont passées dans ce contexte. Le contexte doit être valide jusqu’à ce que la méthode WSManPluginOperationComplete soit appelée par le plug-in pour indiquer que la commande est terminée ou que l’interpréteur de commandes a été arrêté. 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