Compartilhar via

Método IProvideTaskPage::GetPage (mstask.h)

  • Artigo

[[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

Confira também

IProvideTaskPage

TASKPAGE