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 |