IBackgroundCopyJob::GetState-Methode (bits.h)
Ruft den Status des Auftrags ab.
Syntax
HRESULT GetState(
[out] BG_JOB_STATE *pVal
);
Parameter
[out] pVal
Der Status des Auftrags. Der Status gibt beispielsweise an, ob der Auftrag fehlerhaft ist, Daten übertragen oder angehalten ist. Eine Liste der Auftragszustände finden Sie in der BG_JOB_STATE-Enumeration .
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Status des Auftrags wurde erfolgreich abgerufen. |
|
Der Parameter pJobState darf nicht NULL sein. |
Hinweise
Wenn Sie wissen möchten, wann ein Auftrag fehlerhaft ist oder alle Dateien im Auftrag übertragen wurden, können Sie diese Methode verwenden, um den Status des Auftrags abzufragen, oder Sie können sich registrieren, um Benachrichtigungen zu erhalten, wenn Ereignisse auftreten. Ausführliche Informationen zur Registrierung zum Empfangen von Ereignisbenachrichtigungen finden Sie unter der IBackgroundCopyCallback-Schnittstelle .
Beispiele
Sehen Sie sich den Beispielcode für die IBackgroundCopyManager::GetJob-Methode an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | bits.h |
| Bibliothek | Bits.lib |
| DLL | QmgrPrxy.dll |
Weitere Informationen
BG_JOB_STATE, Ermitteln der status eines Auftrags, IBackgroundCopyCallback