Método IScheduledWorkItem::GetWorkItemData (mstask.h)

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

Recupera dados definidos pelo aplicativo associados ao item de trabalho.

Sintaxe

HRESULT GetWorkItemData(
  [out] WORD *pcbData,
  [out] BYTE **prgbData
);

Parâmetros

[out] pcbData

Um ponteiro para o número de bytes copiados.

[out] prgbData

Um ponteiro para um ponteiro para um BYTE que contém dados definidos pelo usuário para o item de trabalho atual. O método que invoca GetWorkItemData é responsável por liberar essa memória usando CoTaskMemFree.

Retornar valor

O método GetWorkItemData retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_INVALIDARG	Os argumentos não são válidos.
E_OUTOFMEMORY	Não existe memória suficiente.

Comentários

Recuperar os dados de um item de trabalho não afeta a operação do item de trabalho de forma alguma.

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

Cotaskmemfree

IScheduledWorkItem

SetWorkItemData