IRegisteredTask::SetSecurityDescriptor-Methode (taskschd.h)

  • Artikel

Legt den Sicherheitsdeskriptor fest, der als Anmeldeinformationen für die registrierte Aufgabe verwendet wird.

Syntax

HRESULT SetSecurityDescriptor(
  [in] BSTR sddl,
  [in] LONG flags
);

Parameter

[in] sddl

Der Sicherheitsdeskriptor, der als Anmeldeinformationen für die registrierte Aufgabe verwendet wird.

Hinweis Wenn dem Lokalen Systemkonto der Zugriff auf eine Aufgabe verweigert wird, kann der Aufgabenplanungsdienst unerwartete Ergebnisse erzeugen.
 

[in] flags

Flags, die angeben, wie der Sicherheitsdeskriptor festgelegt werden soll. Das TASK_DONT_ADD_PRINCIPAL_ACE-Flag aus der TASK_CREATION-Enumeration kann angegeben werden.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Sie können die Zugriffssteuerungsliste (Access Control List, ACL) im Sicherheitsdeskriptor für eine Aufgabe angeben, um bestimmten Benutzern und Gruppen den Zugriff auf eine Aufgabe zu gestatten oder zu verweigern.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile taskschd.h
Bibliothek Taskschd.lib
DLL Taskschd.dll

Weitere Informationen

IRegisteredTask

IRegisteredTask::SetSecurityDescriptor

ITaskFolder::GetSecurityDescriptor