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]
-
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 denselben Anzeigenamen haben können. Darf nicht NULL sein. Der Name ist auf 256 Zeichen beschränkt, ohne den NULL-Abschlussator.
-
Geben Sie [in] ein.
-
Art des Übertragungsauftrags, z. B. BG_JOB_TYPE_DOWNLOAD. Eine Liste der Übertragungstypen finden Sie in der BG_JOB_TYPE-Enumeration .
-
pJobID [out]
-
Identifiziert Eindeutig Ihren Auftrag 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. Geben Sie ppJob frei, 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. |
Bemerkungen
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, Version 1709 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server, Version 1709 [nur Desktop-Apps] |
| Header |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IBackgroundCopyManager ist definiert als 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C |