IPrincipal-Schnittstelle (taskschd.h)

Stellt die Sicherheitsanmeldeinformationen für einen Prinzipal bereit. Diese Sicherheitsanmeldeinformationen definieren den Sicherheitskontext für die Aufgaben, die dem Prinzipal zugeordnet sind.

Vererbung

Die IPrincipal-Schnittstelle erbt von der IDispatch-Schnittstelle.

Methoden

Die IPrincipal-Schnittstelle verfügt über diese Methoden.

 
IPrincipal::get_DisplayName

Ruft den Namen des Prinzipals ab oder legt den Namen des Prinzipals fest. (Get)
IPrincipal::get_GroupId

Ruft den Bezeichner der Benutzergruppe ab, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diesen fest. (Get)
IPrincipal::get_Id

Ruft den Bezeichner des Prinzipals ab oder legt ihn fest. (Get)
IPrincipal::get_LogonType

Ruft die Sicherheitsanmeldungsmethode ab, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diese fest. (Get)
IPrincipal::get_RunLevel

Ruft den Bezeichner ab, der verwendet wird, um die Berechtigungsstufe anzugeben, die zum Ausführen der dem Prinzipal zugeordneten Aufgaben erforderlich ist, oder legt diesen fest. (Get)
IPrincipal::get_UserId

Ruft den Benutzerbezeichner ab, der zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diesen fest. (Get)
IPrincipal::p ut_DisplayName

Ruft den Namen des Prinzipals ab oder legt den Namen des Prinzipals fest. (Put)
IPrincipal::p ut_GroupId

Ruft den Bezeichner der Benutzergruppe ab, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diesen fest. (Put)
IPrincipal::p ut_Id

Ruft den Bezeichner des Prinzipals ab oder legt ihn fest. (Put)
IPrincipal::p ut_LogonType

Ruft die Sicherheitsanmeldungsmethode ab, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diese fest. (Put)
IPrincipal::p ut_RunLevel

Ruft den Bezeichner ab, der verwendet wird, um die Berechtigungsstufe anzugeben, die zum Ausführen der dem Prinzipal zugeordneten Aufgaben erforderlich ist, oder legt diesen fest. (Put)
IPrincipal::p ut_UserId

Ruft den Benutzerbezeichner ab, der zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diesen fest. (Put)

Hinweise

Denken Sie beim Angeben eines Kontos daran, den doppelten umgekehrten Schrägstrich im Code ordnungsgemäß zu verwenden, um den Domänen- und Benutzernamen anzugeben. Verwenden Sie beispielsweise DOMAIN\UserName, um einen Wert für die UserId-Eigenschaft anzugeben.

Beim Lesen oder Schreiben von XML für einen Vorgang werden die Sicherheitsanmeldeinformationen für einen Prinzipal im Principal-Element des Aufgabenplanungsschemas angegeben.

Wenn eine Aufgabe mit dem Befehlszeilentool at.exe registriert wird und diese Schnittstelle zum Abrufen von Informationen zum Task verwendet wird, gibt die LogonType-Eigenschaft 0 zurück, die RunLevel-Eigenschaft gibt 0 zurück, und die UserId-Eigenschaft gibt NULL zurück.

Beispiele

Weitere Informationen und Beispielcode für diese Schnittstelle finden Sie unter Time Trigger Example (C++) or Registration Trigger Example (C++).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile taskschd.h

Weitere Informationen

ITaskDefinition

Principal-Eigenschaft von ITaskDefinition

Aufgabenplanungsschnittstellen