Partager via


WSMAN_PLUGIN_AUTHORIZE_USER fonction de rappel (wsman.h)

Autorise une connexion. Le plug-in doit vérifier que cet utilisateur est autorisé à effectuer des opérations. Si l’utilisateur est autorisé à effectuer des opérations, le plug-in doit signaler une réussite. Si l’utilisateur n’est autorisé à effectuer aucun type d’opération, une défaillance doit être retournée.

Chaque nouvelle connexion n’a pas besoin d’être autorisée. Une fois qu’un utilisateur a été autorisé à se connecter, un enregistrement utilisateur est créé pour suivre les activités de l’utilisateur. Tant que cet enregistrement existe, toutes les nouvelles connexions sont automatiquement autorisées. L’enregistrement utilisateur expire après une période configurable après qu’aucune activité n’a été détectée.

Le nom du point d’entrée DLL pour cette méthode doit être WSManPluginAuthzUser.

Syntaxe

WSMAN_PLUGIN_AUTHORIZE_USER WsmanPluginAuthorizeUser;

void WsmanPluginAuthorizeUser(
  [in] PVOID pluginContext,
  [in] WSMAN_SENDER_DETAILS *senderDetails,
  [in] DWORD flags
)
{...}

Paramètres

[in] pluginContext

Spécifie le contexte retourné par un appel à WSManPluginStartup. Ce paramètre représente une initialisation d’application spécifique d’un plug-in WinRM.

[in] senderDetails

Pointeur vers la structure WSMAN_SENDER_DETAILS qui spécifie les informations d’identification de l’utilisateur à autoriser.

[in] flags

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

Valeur de retour

None

Remarques

Le plug-in doit appeler WSManPluginAuthzUserComplete pour signaler que l’utilisateur a été autorisé avec succès avec NO_ERROR ou qu’il n’a pas été autorisé avec ERROR_ACCESS_DENIED. Une erreur de ERROR_WSMAN_REDIRECT_REQUIRED doit être signalée si une redirection HTTP est requise pour cet utilisateur et si le nouvel URI HTTP doit être enregistré dans extendedErrorInformation de la méthode WSManPluginAuthzUserComplete . Toutes les autres erreurs signalent un échec au client, mais aucune information spécifique n’est signalée.

Spécifications

   
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