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 |
|---|---|
|
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 |
|
| Idl |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IBackgroundCopyManager ist als 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C definiert. |