Metodo ITaskFolder::CreateFolder (taskschd.h)

Crea una cartella per le attività correlate.

Sintassi

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

Parametri

[in] subFolderName

Nome utilizzato per identificare la cartella. Se si specifica "FolderName\SubFolder1\SubFolder2", l'intero albero delle cartelle verrà creato se le cartelle non esistono. Questo parametro può essere un percorso relativo all'istanza corrente ITaskFolder. La cartella dell'attività radice viene specificata con una barra rovesciata (\). Un esempio di percorso della cartella attività, nella cartella dell'attività radice, è \MyTaskFolder. Impossibile utilizzare il carattere '.' per specificare la cartella dell'attività corrente e '.'. Non è possibile utilizzare caratteri per specificare la cartella dell'attività padre nel percorso.

[in] sddl

Descrittore di sicurezza associato alla cartella, sotto forma di VT_BSTR in formato SDDL_REVISION_1.

[out] ppFolder

Interfaccia ITaskFolder che rappresenta la nuova sottocartella.

Passare un riferimento a un puntatore dell'interfacciaNULLITaskFolder. Fare riferimento a un puntatore null non può causare una perdita di memoria perché il puntatore verrà sovrascritto.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Per recuperare le sottocartelle della cartella padre, utilizzare il metodo GetFolders.

Il metodo CreateFolder restituirà 0x800700b7 se la cartella che si sta tentando di creare esiste già.

Se si specifica un descrittore di sicurezza non valido nel parametro sddl , questo metodo restituirà E_INVALIDARG.

Fabbisogno

Vedere anche

ITaskFolder

'utilità di pianificazione