Compartilhar via


Método IBackgroundCopyJob::GetState

Recupera o estado do trabalho.

Sintaxe

HRESULT GetState(
  [out] BG_JOB_STATE *pJobState
);

Parâmetros

pJobState [out]

O estado do trabalho. Por exemplo, o estado reflete se o trabalho está com erro, transferindo dados ou suspenso. Para obter uma lista de estados de trabalho, consulte a enumeração BG_JOB_STATE .

Valor retornado

Esse método retorna os seguintes valores HRESULT , bem como outros.

Código de retorno Descrição
S_OK
O estado do trabalho foi recuperado com êxito.

Comentários

Se você quiser saber quando um trabalho está com erro ou transferiu todos os arquivos no trabalho, você pode usar esse método para sondar o estado do trabalho ou se registrar para receber notificação quando ocorrerem eventos. Para obter detalhes sobre como se registrar para receber a notificação de evento, consulte a interface IBackgroundCopyCallback .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server, versão 1709 [somente aplicativos da área de trabalho]
Cabeçalho
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Biblioteca
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob é definido como 37668D37-507E-4160-9316-26306D150B12

Confira também

IBackgroundCopyJob

BG_JOB_STATE

IBackgroundCopyCallback