IBackgroundCopyManager::GetJob-Methode (bits.h)

Artikel
02/23/2024

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

Syntax

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

Parameter

[in] jobID

Gibt den Auftrag an, der aus der Übertragungswarteschlange abgerufen werden soll. Die CreateJob-Methode gibt den Auftragsbezeichner zurück.

[out] ppJob

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.
BG_E_NOT_FOUND	Der Auftrag wurde in der Warteschlange nicht gefunden.
E_ACCESSDENIED	Der Benutzer verfügt nicht über die Berechtigung zum Abrufen des Auftrags.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits.h
Bibliothek	Bits.lib
DLL	QmgrPrxy.dll

Weitere Informationen

IBackgroundCopyJob

IBackgroundCopyJob::GetId

IBackgroundCopyManager::CreateJob

IBackgroundCopyManager::EnumJobs

Share via