Fonction WSManPluginGetOperationParameters (wsman.h)

Article
03/04/2024

Obtient des informations opérationnelles pour les éléments tels que les délais d’attente et les restrictions de données associés à l’opération. Un plug-in ne doit pas utiliser ces paramètres à d’autres fins que d’information.

Syntaxe

DWORD WSManPluginGetOperationParameters(
  [in]  WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]  DWORD                flags,
  [out] WSMAN_DATA           *data
);

Paramètres

[in] 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.

[in] flags

Spécifie les options disponibles pour la récupération. Ce paramètre doit être défini sur l’une des valeurs suivantes ou sur une valeur définie par le plug-in.

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

Spécifie la taille maximale du paquet de réponse de l’opération. La taille inclut la taille des données ainsi que la surcharge SOAP (Simple Object Access Protocol).

Note Certaines opérations ont un seul appel dans le plug-in qui peut provoquer plusieurs allers-retours. Si aucune requête n’attend des données lorsque cette méthode est appelée, la taille d’enveloppe maximale du paquet précédent est donnée.

WSMAN_PLUGIN_PARAMS_TIMEOUT (2)

Spécifie le délai d’attente de l’opération en cours.

Note Certaines opérations ont un seul appel dans le plug-in qui peut provoquer plusieurs allers-retours. Si aucune requête n’attend des données lorsque cette méthode est appelée, le délai d’attente du paquet précédent est donné.

WSMAN_PLUGIN_PARAMS_REMAINING_RESULT_SIZE (3)

Spécifie l’espace restant pour les données pour l’opération en cours. La taille est basée sur le type d’opération. Par exemple, cet indicateur représenterait la taille de l’élément de résultat unique pour une opération get. Pour les énumérations, la taille diminue une fois chaque objet ajouté. Une fois que le paquet actuel a été rempli avec des énumérations et des opérations d’obtention, il est retourné au client même si d’autres données sont acceptées et mises en cache.

Note Certaines opérations ont un seul appel dans le plug-in qui peut provoquer plusieurs allers-retours. Si aucune requête n’attend des données lorsque cette méthode est appelée, la taille restante est donnée pour un élément mis en cache.

WSMAN_PLUGIN_PARAMS_LARGEST_RESULT_SIZE (4)

Spécifie la taille maximale des données pour l’opération en cours.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_LOCALE (5)

Spécifie les paramètres régionaux de langue qui ont été demandés par le client pour l’opération.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_DATA_LOCALE (6)

Spécifie les paramètres régionaux de langue des données demandées par le client.

[out] data

Pointeur vers une structure WSMAN_DATA qui spécifie l’objet de résultat.

Valeur retournée

La méthode retourne NO_ERROR si elle a réussi ; sinon, il retourne un code d’erreur. Voici les codes d’erreur les plus courants :

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
Bibliothèque	WsmSvc.lib
DLL	WsmSvc.dll
Composant redistribuable	Windows Management Framework sur Windows Server 2008 avec SP2 et Windows Vista avec SP2

Partager via