IBackgroundCopyManager::GetJob-Methode

Artikel
06/13/2023

Ruft einen angegebenen Auftrag aus der Übertragungswarteschlange ab. In der Regel behält Ihre Anwendung den Auftragsbezeichner bei, sodass Sie den Auftrag später aus der Warteschlange abrufen können.

Syntax

HRESULT GetJob(
  [in]  REFGUID            JobID,
  [out] IBackgroundCopyJob **ppJob
);

Parameter

JobID [in]: Gibt den Auftrag an, der aus der Übertragungswarteschlange abgerufen werden soll. Die CreateJob-Methode gibt den Auftragsbezeichner zurück.
ppJob [out]: Ein IBackgroundCopyJob-Schnittstellenzeiger auf den durch JobID angegebenen Auftrag. Wenn Sie fertig sind, geben Sie ppJob frei.

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Der Auftrag wurde erfolgreich aus der Übertragungswarteschlange abgerufen.
DO_E_NOT_FOUND	Der Auftrag wurde nicht in der Warteschlange gefunden.
E_ACCESSDENIED	Der Benutzer verfügt nicht über die Berechtigung zum Abrufen des Auftrags.

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	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Bibliothek	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager ist definiert als 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C

Siehe auch

IBackgroundCopyManager
IBackgroundCopyJob
IBackgroundCopyJob::GetId
IBackgroundCopyManager::CreateJob

Freigeben über