Método ITaskFolder::CreateFolder (taskschd.h)
Crea una carpeta para las tareas relacionadas.
Sintaxis
HRESULT CreateFolder(
[in] BSTR subFolderName,
[in] VARIANT sddl,
[out] ITaskFolder **ppFolder
);
Parámetros
[in] subFolderName
Nombre que se usa para identificar la carpeta. Si se especifica "FolderName\SubFolder1\SubFolder2", se creará todo el árbol de carpetas si las carpetas no existen. Este parámetro puede ser una ruta de acceso relativa a la instancia actual de ITaskFolder. La carpeta de tareas raíz se especifica con una barra diagonal inversa (\). Un ejemplo de una ruta de acceso de carpeta de tareas, en la carpeta de tareas raíz, es \MyTaskFolder. No se puede usar el carácter '.' para especificar la carpeta de tareas actual y '.'. no se pueden usar caracteres para especificar la carpeta de tareas primaria en la ruta de acceso.
[in] sddl
Descriptor de seguridad asociado a la carpeta, en forma de un VT_BSTR en formato SDDL_REVISION_1.
[out] ppFolder
Interfaz ITaskFolder que representa la nueva subcarpeta.
Pase una referencia a un
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.
Observaciones
Para recuperar las subcarpetas de la carpeta primaria, use el método GetFolders.
El método CreateFolder devolverá 0x800700b7 si la carpeta que está intentando crear ya existe.
Al especificar un descriptor de seguridad no válido en el parámetro sddl, este método devolverá E_INVALIDARG.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
taskschd.h |
| biblioteca de |
Taskschd.lib |
| DLL de |
Taskschd.dll |
Consulte también
programador de tareas de