Metodo IBackgroundCopyQMgr::GetGroup (qmgr.h)

[IBackgroundCopyQMgr è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece le interfacce BITS.

Usare il metodo GetGroup per recuperare un gruppo dalla coda di download. L'utente corrente può recuperare solo i gruppi proprietari. Se l'utente ha privilegi di amministratore, l'utente può recuperare qualsiasi gruppo dalla coda di download. Il recupero di un gruppo dalla coda trasferisce la proprietà del gruppo all'utente corrente.

Sintassi

HRESULT GetGroup(
  [in]  GUID                 groupID,
  [out] IBackgroundCopyGroup **ppGroup
);

Parametri

[in] groupID

GUID che identifica in modo univoco il gruppo nella coda di download.

[out] ppGroup

Puntatore a un puntatore dell'interfaccia IBackgroundCopyGroup . Usare questa interfaccia per gestire il gruppo. Ad esempio, aggiungere un processo al gruppo e impostare le proprietà del gruppo.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito Descrizione
S_OK
È stato recuperato correttamente il gruppo.
QM_E_ITEM_NOT_FOUND
Impossibile trovare il gruppo nella coda di download.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Piattaforma di destinazione Windows
Intestazione qmgr.h
DLL QmgrPrxy.dll

Vedi anche

IBackgroundCopyQMgr