IBackgroundCopyManager::CreateJob-Methode (bits.h)

Erstellt einen Auftrag.

Syntax

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

Die 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 Stellen möglicherweise denselben Anzeigenamen haben. Darf nicht NULL sein. Der Name ist auf 256 Zeichen beschränkt, nicht einschließlich des Null-Terminators.

[in] Type

Art des Transferauftrags, z. B. BG_JOB_TYPE_DOWNLOAD. Eine Liste der Übertragungstypen finden Sie in der BG_JOB_TYPE Enumeration.

[out] pJobId

Identifiziert Ihren Auftrag eindeutig in der Warteschlange. 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. Rufen Sie zum Aktivieren des Auftrags in der Warteschlange die IBackgroundCopyJob::Resume-Methode auf. Veröffentlichen Sie ppJob , wenn Sie fertig sind.

Rückgabewert

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

Bemerkungen

Nur der Benutzer, der den Auftrag oder einen Benutzer mit Administratorrechten erstellt, 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. Der Benutzergrenzwert 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".

Examples

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

Anforderungen

Siehe auch

Erstellen eines Auftrags

IBackgroundCopyJob

IBackgroundCopyJob::Resume