Freigeben über

IBackgroundCopyManager::EnumJobs-Methode (bits.h)

Ruft einen Schnittstellenzeiger auf ein Enumerationsobjekt ab, das Sie zum Aufzählen der Aufträge in der Übertragungswarteschlange verwenden. Die Reihenfolge der Aufträge im Enumerator ist beliebig.

Syntax

HRESULT EnumJobs(
  [in]  DWORD                   dwFlags,
  [out] IEnumBackgroundCopyJobs **ppEnum
);

Die Parameter

[in] dwFlags

Gibt an, deren Aufträge in die Enumeration eingeschlossen werden sollen. Wenn dwFlags auf 0 festgelegt ist, erhält der Benutzer alle Aufträge, die er in der Übertragungswarteschlange besitzt. In der folgenden Tabelle sind die Enumerationsoptionen aufgeführt.

Option Bedeutung
BG_JOB_ENUM_ALL_USERS
 Umfasst alle Aufträge in der Übertragungswarteschlange – diejenigen, die dem Benutzer gehören und denen, die im Besitz anderer sind. Der Benutzer muss ein Administrator sein, um dieses Flag zu verwenden.

[out] ppEnum

Ein IEnumBackgroundCopyJobs-Schnittstellenzeiger , den Sie zum Aufzählen der Aufträge in der Übertragungswarteschlange verwenden. Der Inhalt des Enumerators hängt vom Wert von dwFlags ab. Veröffentlichen Sie ppEnumJobs , wenn Sie fertig sind.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode Description
S_OK
 Das Enumeratorobjekt wurde erfolgreich generiert.
E_ACCESSDENIED
 Der Benutzer muss ein Administrator sein oder einer Administratorgruppe angehören, um Aufträge im Besitz eines anderen Benutzers auflisten zu können.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP
Mindestanforderungen für unterstützte Server Windows Server 2003
Zielplattform Fenster
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

Siehe auch

IBackgroundCopyJob::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs

  • Last updated on