Método ITaskService::GetFolder (taskschd.h)

Obtém uma pasta de tarefas registradas.

Sintaxe

HRESULT GetFolder(
  [in]  BSTR        path,
  [out] ITaskFolder **ppFolder
);

Parâmetros

[in] path

O caminho para a pasta a ser recuperada. Não use uma barra invertida após o nome da última pasta no caminho. A pasta da tarefa raiz é especificada com uma barra invertida (\). Um exemplo de um caminho de pasta de tarefas, na pasta de tarefas raiz, é \MyTaskFolder. O caractere '.' não pode ser usado para especificar a pasta de tarefas atual e o '.'. os caracteres não podem ser usados para especificar a pasta de tarefas pai no caminho.

[out] ppFolder

Uma interface ITaskFolder para a pasta solicitada.

Passe uma referência para um ponteiro de interface ITaskFolderNULL. Fazer referência a um ponteiro não NULL pode causar um vazamento de memória porque o ponteiro será substituído.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	taskschd.h
Biblioteca	Taskschd.lib
DLL	Taskschd.dll

Confira também

ITaskService

Agendador de Tarefas