IBackgroundCopyManager::GetJob-Methode (bits.h)

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