Método ITaskFolder::CreateFolder (taskschd.h)

Artigo
07/16/2024

Cria uma pasta para tarefas relacionadas.

Sintaxe

HRESULT CreateFolder(
  [in]  BSTR        subFolderName,
  [in]  VARIANT     sddl,
  [out] ITaskFolder **ppFolder
);

Parâmetros

[in] subFolderName

O nome usado para identificar a pasta. Se "FolderName\SubFolder1\SubFolder2" for especificado, toda a árvore de pastas será criada se as pastas não existirem. Esse parâmetro pode ser um caminho relativo para a instância de ITaskFolder atual. A pasta de tarefa raiz é especificada com uma barra invertida (\). Um exemplo de um caminho de pasta de tarefa, na pasta de tarefa raiz, é \MyTaskFolder. O caractere '.' não pode ser usado para especificar a pasta de tarefa atual e o '.'. os caracteres não podem ser usados para especificar a pasta de tarefa pai no caminho.

[in] sddl

O descritor de segurança associado à pasta, na forma de um VT_BSTR no formato SDDL_REVISION_1.

[out] ppFolder

Uma interface ITaskFolder que representa a nova subpasta.

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

Valor de retorno

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

Observações

Para recuperar as subpastas da pasta pai, use o método GetFolders.

O método CreateFolder retornará 0x800700b7 se a pasta que você está tentando criar já existir.

Especificar um descritor de segurança inválido no parâmetro sddl do fará com que esse método retorne E_INVALIDARG.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	taskschd.h
biblioteca	Taskschd.lib
de DLL	Taskschd.dll

Consulte também

ITaskFolder

do Agendador de Tarefas

Compartilhar via