IScheduledWorkItem::GetWorkItemData-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 anwendungsdefinierte Daten ab, die dem Arbeitselement zugeordnet sind.
Syntax
HRESULT GetWorkItemData(
[out] WORD *pcbData,
[out] BYTE **prgbData
);
Parameter
[out] pcbData
Ein Zeiger auf die Anzahl der kopierten Bytes.
[out] prgbData
Ein Zeiger auf einen Zeiger auf einen BYTE, der benutzerdefinierte Daten für das aktuelle Arbeitselement enthält. Die Methode, die GetWorkItemData aufruft, ist dafür verantwortlich, diesen Arbeitsspeicher mithilfe von CoTaskMemFree freizugeben.
Rückgabewert
Die GetWorkItemData-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. |
Hinweise
Das Abrufen der Daten eines Arbeitselements wirkt sich in keiner Weise auf den Vorgang des Arbeitselements aus.
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 |
| Verteilbare Komponente | Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95 |