Metodo IBackgroundCopyManager::CreateJob

Articolo
06/12/2023

Crea un processo.

Sintassi

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

Parametri

pDisplayName [in]: 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, senza includere il carattere di terminazione Null.
Tipo [in]: Tipo di processo di trasferimento, ad esempio BG_JOB_TYPE_DOWNLOAD. Per un elenco dei tipi di trasferimento, vedere l'enumerazione BG_JOB_TYPE .
pJobID [out]: Identifica in modo univoco il processo nella coda. Usare questo identificatore quando si chiama il metodo IBackgroundCopyManager::GetJob per ottenere un processo dalla coda.
ppJob [out]: Puntatore all'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 . Al termine, rilasciare ppJob .

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il nuovo processo è stato generato correttamente.

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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server, versione 1709 [solo app desktop]
Intestazione	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Libreria	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager è definito come 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C

Vedi anche

IBackgroundCopyManager
IBackgroundCopyJob
IBackgroundCopyJob::Resume

Condividi tramite