IBackgroundCopyManager::CreateJob-Methode

Erstellt einen Auftrag.

Syntax

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

Parameter

pDisplayName [ In]

Auf NULL endende Zeichenfolge, die einen Anzeigenamen für den Auftrag enthält. In der Regel wird der Anzeigename verwendet, um den Auftrag auf einer Benutzeroberfläche zu identifizieren. Beachten Sie, dass mehr als ein Auftrag den gleichen Anzeigenamen aufweisen kann. Darf nicht NULL sein. Der Name ist auf 256 Zeichen beschränkt, ohne das NULL-Abschlusszeichen.

Typ [ In]

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

pJobID [ out]

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.

ppJob [ out]

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. Veröffentlichen Sie ppJob, 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.

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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10, nur Desktop-Apps der Version 1709 []
Unterstützte Mindestversion (Server)
Windows Server, nur Desktop-Apps der Version 1709 []
Header
Deliveryoptimization.h
Idl
DeliveryOptimization.idl
Bibliothek
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyManager ist als 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C definiert.

Siehe auch

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob::Resume