structure WSMAN_PLUGIN_REQUEST (wsman.h)

Spécifie les informations d’une demande de plug-in. Un pointeur vers une structure WSMAN_PLUGIN_REQUEST est passé à tous les points d’entrée d’opération au sein du plug-in. Toutes les méthodes de notification de résultats utilisent ce pointeur pour faire correspondre le résultat à la demande. Toutes les informations de la structure restent valides jusqu’à ce que le plug-in appelle WSManPluginOperationComplete sur l’opération.

Syntaxe

typedef struct _WSMAN_PLUGIN_REQUEST {
  WSMAN_SENDER_DETAILS *senderDetails;
  PCWSTR               locale;
  PCWSTR               resourceUri;
  WSMAN_OPERATION_INFO *operationInfo;
  BOOL                 shutdownNotification;
  HANDLE               shutdownNotificationHandle;
  PCWSTR               dataLocale;
} WSMAN_PLUGIN_REQUEST;

Membres

senderDetails

Pointeur vers une structure de WSMAN_SENDER_DETAILS qui spécifie des détails sur le client qui a lancé la demande.

locale

Spécifie les paramètres régionaux que l’utilisateur a demandé aux résultats. Si les paramètres régionaux demandés ne sont pas disponibles, les options suivantes sont disponibles :

• Les paramètres régionaux système sont utilisés.
• La demande est rejetée avec une erreur de paramètres régionaux non valides.

Tout appel au plug-in aura les paramètres régionaux sur le thread définis sur les paramètres régionaux spécifiés dans ce membre. Si le plug-in a d’autres threads qui travaillent sur la demande, le plug-in doit définir les paramètres régionaux en conséquence sur chaque thread qu’il utilise.

resourceUri

Spécifie l’URI de ressource pour cette opération.

operationInfo

Pointeur vers une structure WSMAN_OPERATION_INFO qui contient des informations supplémentaires sur l’opération. Certaines des informations de cette structure seront NULL , car tous les paramètres ne sont pas pertinents pour toutes les opérations.

shutdownNotification

Si l’opération est annulée, le membre shutdownNotification est défini sur TRUE.

shutdownNotificationHandle

Si l’opération est annulée, shutdownNotification est signalé.

dataLocale

Remarques

Les opérations doivent signaler le rappel pour que l’opération indique qu’elle a été arrêtée. Les opérations sont annulées de manière hiérarchique pour garantir que toutes les opérations de suivi sont annulées avant les opérations de niveau supérieur. Un plug-in a deux façons de gérer l’annulation d’une opération. Tout d’abord, le plug-in peut case activée la valeur booléenne shutdownNotification s’il itère au sein d’un ensemble de résultats. Deuxièmement, si le plug-in est de nature plus asynchrone, le paramètre shutdownNotificationHandle peut être utilisé lors de la mise en file d’attente de threads de notification asynchrones.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
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