structure WSMAN_PLUGIN_REQUEST (wsman.h)

Spécifie des informations pour une demande de plug-in. Un pointeur vers une structure WSMAN_PLUGIN_REQUEST est passé à tous les points d’entrée d’opération dans le plug-in. Toutes les méthodes de notification de résultat 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 WSMAN_SENDER_DETAILS qui spécifie des détails sur le client qui a lancé la requête.

locale

Spécifie les paramètres régionaux dans lequel l’utilisateur a demandé des 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 valide.

Tout appel au plug-in aura les paramètres régionaux sur le thread défini sur les paramètres régionaux spécifiés dans ce membre. Si le plug-in a d’autres threads qui fonctionnent 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 sont 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 a la valeur TRUE.

shutdownNotificationHandle

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

dataLocale

Remarques

Les opérations doivent signaler le rappel de l’opération pour indiquer qu’elle a été arrêtée. Les opérations sont annulées de manière hiérarchique pour s’assurer 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 vérifier la valeur booléenne shutdownNotification si elle itère dans un ensemble de résultats. Ensuite, si le plug-in est de nature plus asynchrone, l’shutdownNotificationHandle peut être utilisé lors de la mise en file d’attente de threads de notification asynchrones.

Configuration requise

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