Méthode IAutomaticUpdatesSettings2 ::CheckPermission (wuapi.h)

  • Article

[IAutomaticUpdatesSettings2 ::CheckPermission n’est plus pris en charge. À compter de Windows 10 appels à CheckPermission retournent toujours S_OK et une valeur de retour de VARIANT_TRUE (les utilisateurs disposent d’autorisations). Toutefois, IAutomaticUpdatesSettings ::Save étant une opération sans opération, aucune modification ne peut être apportée.]

Détermine si un utilisateur ou un type d’utilisateur spécifique est autorisé à effectuer une action sélectionnée.

Syntaxe

HRESULT CheckPermission(
  [in] AutomaticUpdatesUserType       userType,
  [in] AutomaticUpdatesPermissionType permissionType,
       VARIANT_BOOL                   *userHasPermission
);

Paramètres

[in] userType

Énumération qui indique le type d’utilisateur à vérifier les autorisations.

[in] permissionType

Énumération qui indique le niveau d’autorisation de l’utilisateur.

userHasPermission

True si l’utilisateur a le type d’autorisation spécifié ; sinon, false.

Valeur retournée

Retourne S_OK en cas de réussite. Sinon, retourne un code d’erreur COM ou Windows.

Remarques

Cette méthode peut être utilisée pour déterminer si l’utilisateur Access Control (UAC) doit être utilisé pour effectuer une action dans l’agent, ce qui peut ne pas nécessiter d’invite si le type d’utilisateur n’est pas autorisé à effectuer l’action. Par exemple, à moins que l’agent ne dispose d’autorisations élevées, la propriété ReadOnly de l’interface IAutomaticUpdatesSettings sera toujours VARIANT_TRUE. Toutefois, même une fois qu’un utilisateur a été élevé, notificationLevel (par exemple) peut toujours être en lecture seule en raison des paramètres de stratégie de groupe. La méthode CheckPermission peut le déterminer avant que l’élévation ne soit effectuée pour empêcher l’invite dans les cas où le paramètre ne peut pas être modifié.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wuapi.h
Bibliothèque Wuguid.lib
DLL Wuapi.dll

Voir aussi

IAutomaticUpdatesSettings2