IAutomaticUpdatesSettings2::CheckPermission-Methode (wuapi.h)

  • Artikel

[IAutomaticUpdatesSettings2::CheckPermission wird nicht mehr unterstützt. Ab Windows 10 Aufrufen von CheckPermission werden immer S_OK und der Rückgabewert VARIANT_TRUE zurückgegeben (Benutzer verfügen über Berechtigungen). IAutomaticUpdatesSettings::Save ist jedoch ein no-op, sodass keine Änderungen vorgenommen werden können.]

Bestimmt, ob ein bestimmter Benutzer oder Ein bestimmter Benutzertyp über die Berechtigung zum Ausführen einer ausgewählten Aktion verfügt.

Syntax

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

Parameter

[in] userType

Eine Enumeration, die den Typ des Zu überprüfenden Benutzers angibt.

[in] permissionType

Eine Enumeration, die die Berechtigungsstufe des Benutzers angibt.

userHasPermission

True, wenn der Benutzer über den angegebenen Berechtigungstyp verfügt; Andernfalls false.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein COM- oder Windows-Fehlercode zurückgegeben.

Hinweise

Diese Methode kann verwendet werden, um zu bestimmen, ob user Access Control (UAC) verwendet werden muss, um eine Aktion im Agent auszuführen, wodurch die Notwendigkeit einer Aufforderung entfällt, wenn der Benutzertyp nicht über die Berechtigung zum Ausführen der Aktion verfügt. Wenn der Agent beispielsweise nicht über erhöhte Berechtigungen verfügt, wird die ReadOnly-Eigenschaft der IAutomaticUpdatesSettings-Schnittstelle immer VARIANT_TRUE. Auch wenn ein Benutzer mit erhöhten Rechten versehen wurde, kann notificationLevel (z. B.) aufgrund von Gruppenrichtlinie Einstellungen weiterhin schreibgeschützt sein. Die CheckPermission-Methode kann dies ermitteln, bevor die Rechteerweiterung erfolgt, um die Aufforderung in Fällen zu verhindern, in denen die Einstellung nicht geändert werden kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wuapi.h
Bibliothek Wuguid.lib
DLL Wuapi.dll

Weitere Informationen

IAutomaticUpdatesSettings2