IScheduledWorkItem::GetAccountInformation-Methode (mstask.h)
[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]
Ruft den Kontonamen für das Arbeitselement ab.
Syntax
HRESULT GetAccountInformation(
[out] LPWSTR *ppwszAccountName
);
Parameter
[out] ppwszAccountName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Kontonamen für das aktuelle Arbeitselement enthält. Die leere Zeichenfolge L"" wird für das lokale Systemkonto zurückgegeben.
Rufen Sie nach der Verarbeitung des Kontonamens Unbedingt CoTaskMemFree auf, um die Zeichenfolge frei zu geben.
Rückgabewert
Die GetAccountInformation-Methode gibt einen der folgenden Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Die Argumente sind ungültig. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar. |
|
Die Kontoinformationen wurden nicht für das Arbeitselement festgelegt. |
|
Sicherheitsdienste sind nur unter den Betriebssystemen Windows Server 2003, Windows 2000 und Windows XP verfügbar. |
Hinweise
Die GetAccountInformation-Methode gilt für die Betriebssysteme Windows Server 2003, Windows XP und Windows 2000.
Beispiele
Weitere Informationen und ein Beispiel zum Abrufen der Kontoinformationen einer Aufgabe finden Sie unter C/C++-Codebeispiel: Abrufen von Aufgabenkontoinformationen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mstask.h |
| Bibliothek | Mstask.lib |
| DLL | Mstask.dll |