WSManPluginAuthzOperationComplete, fonction (wsman.h)

Appelé à partir du point d’entrée du plug-in WSManPluginAuthzOperation . Il signale une autorisation réussie ou ayant échoué pour une opération utilisateur.

Syntaxe

DWORD WSManPluginAuthzOperationComplete(
  [in]           WSMAN_SENDER_DETAILS *senderDetails,
  [in]           DWORD                flags,
  [in, optional] PVOID                userAuthorizationContext,
  [in]           DWORD                errorCode,
  [in, optional] PCWSTR               extendedErrorInformation
);

Paramètres

[in] senderDetails

Pointeur vers la structure WSMAN_SENDER_DETAILS passée à l’appel du plug-in WSManPluginAuthzOperation .

[in] flags

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

[in, optional] userAuthorizationContext

Spécifie un contexte défini par un plug-in qui est utilisé pour faciliter le suivi des informations de contexte utilisateur. Ce contexte peut être retourné à plusieurs appels, à cet appel ou à un appel d’opération. Le plug-in gère le comptage des références pour tous les appels. Si l’enregistrement utilisateur expire ou si une nouvelle autorisation est requise, l’infrastructure WinRM (WinRM) appelle WSManPluginAuthzReleaseContext.

[in] errorCode

Signale une autorisation réussie ou ayant échoué. Si l’autorisation réussit, le code doit être ERROR_SUCCESS. Si l’utilisateur n’est pas autorisé à effectuer l’opération, l’erreur doit être ERROR_ACCESS_DENIED. Si un échec se produit pour une autre raison, un code d’erreur approprié doit être utilisé. Toute erreur de cet appel est renvoyée en tant que paquet d’erreur SOAP (Simple Object Access Protocol).

[in, optional] extendedErrorInformation

Spécifie un document XML qui contient toutes les informations d’erreur supplémentaires qui doivent être signalées au client. Ce paramètre est ignoré si errorCode est NO_ERROR. La langue de l’interface utilisateur du thread doit être utilisée pour la localisation.

Valeur retournée

La méthode retourne ERROR_SUCCESS si elle a réussi ; sinon, elle retourne ERROR_INVALID_PARAMETER. Si ERROR_INVALID_PARAMETER est retourné, le paramètre senderDetails était NULL ou le paramètre flags n’était pas zéro.

Configuration requise