Compartilhar via


Método IEnumWorkItems::Clone (mstask.h)

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Cria um novo objeto de enumeração que contém o mesmo estado de enumeração que a enumeração atual.

Como o novo objeto aponta para o mesmo lugar na sequência de enumeração, um cliente pode usar o método Clone para registrar um ponto específico na sequência de enumeração e retornar a esse ponto mais tarde.

Sintaxe

HRESULT Clone(
  [out] IEnumWorkItems **ppEnumWorkItems
);

Parâmetros

[out] ppEnumWorkItems

Um ponteiro para um ponteiro para uma nova interface IEnumWorkItems . Esse ponteiro apontará para a enumeração recém-criada. Se o método falhar, esse parâmetro será indefinido.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
A operação foi bem-sucedida.
E_INVALIDARG
O argumento não é válido.
E_OUTOFMEMORY
Não há memória suficiente.
E_UNEXPECTED
Ocorreu um erro.

Comentários

A interface IEnumWorkItems também fornece métodos para recuperar conjuntos de tarefas, ignorar conjuntos de tarefas e redefinir a sequência de enumeração.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mstask.h
Biblioteca Mstask.lib
DLL Mstask.dll
Redistribuível Internet Explorer 4.0 ou posterior no Windows NT 4.0 e Windows 95

Confira também

IEnumWorkItems

IEnumWorkItems::Next

IEnumWorkItems::Reset

IEnumWorkItems::Skip