Método IProvideTaskPage::GetPage (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 .] ]
Esse método recupera uma ou mais páginas de folha de propriedades associadas a um objeto de tarefa.
Sintaxe
HRESULT GetPage(
[in] TASKPAGE tpType,
[in] BOOL fPersistChanges,
[out] HPROPSHEETPAGE *phPage
);
Parâmetros
[in] tpType
Um dos seguintes valores de enumeração TASKPAGE que especificam a página a ser retornada.
TASKPAGE_TASK
Propriedade de página geral.
TASKPAGE_SCHEDULE
Agende propriedades para a tarefa.
TASKPAGE_SETTINGS
Propriedades de configurações para a tarefa.
[in] fPersistChanges
Especifica se as alterações no objeto de tarefa são tornadas persistentes automaticamente. Se TRUE, a página atualizará o objeto de tarefa persistente automaticamente se houver uma alteração feita na versão. Se FALSE, o chamador será responsável por tornar as alterações de objeto de tarefa persistentes chamando IPersistFile::Save no objeto de tarefa.
[out] phPage
Manipule para a página de folha de propriedades retornada do objeto de tarefa. Esse identificador pode ser usado para exibir a página.
Retornar valor
Retorna S_OK se o método foi bem-sucedido ou STG_E_NOTFILEBASEDSTORAGE se a tarefa não tiver sido salva no disco.
Comentários
Para recuperar a interface IProvideTaskPage , chame ITask::QueryInterface.
O código a seguir mostra a declaração de variável e a sintaxe de chamada para usar esse método e para chamar ITask::QueryInterface.
Exemplos
Para obter um exemplo completo de recuperação e exibição da página de tarefas gerais de uma tarefa conhecida, consulte Recuperando um exemplo de página de tarefa
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 |