Metodo IBackgroundCopyJob::GetState (bits.h)

Recupera lo stato del processo.

Sintassi

HRESULT GetState(
  [out] BG_JOB_STATE *pVal
);

Parametri

[out] pVal

Stato del processo. Ad esempio, lo stato indica se il processo è in errore, il trasferimento di dati o la sospensione. Per un elenco degli stati del processo, vedere l'enumerazione BG_JOB_STATE .

Valore restituito

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

Codice restituito Descrizione
S_OK
Lo stato del processo è stato recuperato correttamente.
E_INVALIDARG
Il parametro pJobState non può essere NULL.

Commenti

Se si vuole sapere quando un processo è in errore o ha trasferito tutti i file nel processo, è possibile usare questo metodo per eseguire il polling dello stato del processo oppure registrarsi per ricevere una notifica quando si verificano gli eventi. Per informazioni dettagliate sulla registrazione per ricevere la notifica degli eventi, vedere l'interfaccia IBackgroundCopyCallback .

Esempio

Vedere il codice di esempio per il metodo IBackgroundCopyManager::GetJob .

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

BG_JOB_STATE, Determinazione dello stato di un processo, IBackgroundCopyCallback