Metodo IBackgroundCopyManager::CreateJob (bits.h)

Articolo
08/22/2023

Crea un processo.

Sintassi

HRESULT CreateJob(
  [in]  LPCWSTR            DisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobId,
  [out] IBackgroundCopyJob **ppJob
);

Parametri

[in] DisplayName

Stringa con terminazione null contenente un nome visualizzato per il processo. In genere, il nome visualizzato viene usato per identificare il processo in un'interfaccia utente. Si noti che più di un processo può avere lo stesso nome visualizzato. Non deve essere NULL. Il nome è limitato a 256 caratteri, non incluso il terminatore Null.

[in] Type

Tipo di processo di trasferimento, ad esempio BG_JOB_TYPE_DOWNLOAD. Per un elenco di tipi di trasferimento, vedere l'enumerazione BG_JOB_TYPE .

[out] pJobId

Identifica in modo univoco il processo nella coda. Usare questo identificatore quando si chiama il metodo IBackgroundCopyManager::GetJob per ottenere un processo dalla coda.

[out] ppJob

Puntatore dell'interfaccia IBackgroundCopyJob usato per modificare le proprietà del processo e specificare i file da trasferire. Per attivare il processo nella coda, chiamare il metodo IBackgroundCopyJob::Resume . Rilasciare ppJob al termine.

Valore restituito

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

Codice restituito	Descrizione
S_OK	È stato generato correttamente il nuovo processo.
E_INVALIDARG	Il nome visualizzato è troppo lungo.
BG_E_TOO_MANY_JOBS_PER_MACHINE	L'impostazione MaxJobsPerMachine Criteri di gruppo determina il numero di processi che possono essere creati nel computer. L'aggiunta di questo processo supera il limite MaxJobsPerMachine.
BG_E_TOO_MANY_JOBS_PER_USER	L'impostazione maxJobsPerUser Criteri di gruppo determina il numero di processi che un utente può creare. L'aggiunta di questo processo supera il limite MaxJobsPerUser.

Commenti

Solo l'utente che crea il processo o un utente con privilegi di amministratore può aggiungere file al processo e modificare le proprietà del processo.

Per impostazione predefinita, BITS supporta un massimo di 300 processi alla volta. Un singolo utente può creare un massimo di 60 processi alla volta. Il limite utente non si applica agli amministratori o agli account di servizio. Per modificare queste impostazioni predefinite, impostare rispettivamente i criteri di gruppo MaxJobsPerMachine e MaxJobsPerUser .

Prima di Windows Vista: Non esiste alcun limite per il numero di processi supportati da BITS o che un utente può creare.

Per i problemi di scalabilità, vedere Procedure consigliate per l'uso di BITS.

Esempio

Per un esempio che crea un nuovo processo, vedere Creazione di un processo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bits.h
Libreria	Bits.lib
DLL	QmgrPrxy.dll

Vedi anche

Creazione di un processo

IBackgroundCopyJob

IBackgroundCopyJob::Resume

Condividi tramite