IBackgroundCopyManager::CreateJob-Methode (bits.h)

Artikel
02/28/2024

Erstellt einen Auftrag.

Syntax

HRESULT CreateJob(
  [in]  LPCWSTR            DisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobId,
  [out] IBackgroundCopyJob **ppJob
);

Parameter

[in] DisplayName

Null-beendete Zeichenfolge, die einen Anzeigenamen für den Auftrag enthält. In der Regel wird der Anzeigename verwendet, um den Auftrag in einer Benutzeroberfläche zu identifizieren. Beachten Sie, dass mehrere Aufträge den gleichen Anzeigenamen haben können. Darf nicht NULL sein. Der Name ist auf 256 Zeichen beschränkt, ohne das NULL-Abschlusszeichen.

[in] Type

Typ des Übertragungsauftrags, z. B. BG_JOB_TYPE_DOWNLOAD. Eine Liste der Übertragungstypen finden Sie in der BG_JOB_TYPE-Enumeration .

[out] pJobId

Identifiziert Ihren Auftrag in der Warteschlange eindeutig. Verwenden Sie diesen Bezeichner, wenn Sie die IBackgroundCopyManager::GetJob-Methode aufrufen, um einen Auftrag aus der Warteschlange abzurufen.

[out] ppJob

Ein IBackgroundCopyJob-Schnittstellenzeiger , mit dem Sie die Eigenschaften des Auftrags ändern und die zu übertragenden Dateien angeben. Um den Auftrag in der Warteschlange zu aktivieren, rufen Sie die IBackgroundCopyJob::Resume-Methode auf. Geben Sie ppJob frei, wenn Sie fertig sind.

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Der neue Auftrag wurde erfolgreich generiert.
E_INVALIDARG	Der Anzeigename ist zu lang.
BG_E_TOO_MANY_JOBS_PER_MACHINE	Die Einstellung MaxJobsPerMachine Gruppenrichtlinie bestimmt, wie viele Aufträge auf dem Computer erstellt werden können. Das Hinzufügen dieses Auftrags überschreitet den MaxJobsPerMachine-Grenzwert.
BG_E_TOO_MANY_JOBS_PER_USER	Die Einstellung MaxJobsPerUser Gruppenrichtlinie bestimmt, wie viele Aufträge ein Benutzer erstellen kann. Das Hinzufügen dieses Auftrags überschreitet den MaxJobsPerUser-Grenzwert.

Hinweise

Nur der Benutzer, der den Auftrag erstellt, oder ein Benutzer mit Administratorrechten kann dem Auftrag Dateien hinzufügen und die Eigenschaften des Auftrags ändern.

Bits unterstützt standardmäßig maximal 300 Aufträge gleichzeitig. Ein einzelner Benutzer kann maximal 60 Aufträge gleichzeitig erstellen. Das Benutzerlimit gilt nicht für Administratoren oder Dienstkonten. Um diese Standardwerte zu ändern, legen Sie die Gruppenrichtlinien MaxJobsPerMachine bzw . MaxJobsPerUser fest.

Vor Windows Vista: Es gibt keine Beschränkung für die Anzahl von Aufträgen, die BITS unterstützt oder die ein Benutzer erstellen kann.

Informationen zu Skalierbarkeitsproblemen finden Sie unter Bewährte Methoden bei der Verwendung von BITS.

Beispiele

Ein Beispiel zum Erstellen eines neuen Auftrags finden Sie unter Erstellen eines Auftrags.

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

Erstellen eines Auftrags

IBackgroundCopyJob

IBackgroundCopyJob::Resume

Share via