Metodo ITaskFolder::RegisterTask (taskschd.h)
Registra (crea) una nuova attività nella cartella utilizzando XML per definire l'attività.
Sintassi
HRESULT RegisterTask(
[in] BSTR path,
[in] BSTR xmlText,
[in] LONG flags,
[in] VARIANT userId,
[in] VARIANT password,
[in] TASK_LOGON_TYPE logonType,
[in, optional] VARIANT sddl,
[out] IRegisteredTask **ppTask
);
Parametri
[in] path
Nome dell'attività. Se questo valore è NULL, l'attività verrà registrata nella cartella dell'attività radice e il nome dell'attività sarà un valore GUID creato dal servizio Utilità di pianificazione.
Un nome di attività non può iniziare o terminare con un carattere di spazio. 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] xmlText
Definizione in formato XML dell'attività.
Gli argomenti seguenti contengono attività definite tramite XML.
- Esempio di trigger ora (XML)
- esempio di trigger di evento (XML)
- esempio di trigger giornaliero (XML)
- esempio di trigger di registrazione (XML)
- esempio di trigger settimanale (XML)
- esempio di trigger di accesso (XML)
- Esempio di trigger di avvio (XML)
[in] flags
Costante TASK_CREATION.
[in] userId
Credenziali utente usate per registrare l'attività.
[in] password
Password per l'id utente usato per registrare l'attività. Quando viene usato il tipo di accesso TASK_LOGON_SERVICE_ACCOUNT, la password deve essere un valore VARIANT vuoto, ad esempio VT_NULL o VT_EMPTY.
[in] logonType
Valore che definisce la tecnica di accesso usata per eseguire l'attività registrata.
[in, optional] sddl
Descrittore di sicurezza associato all'attività registrata. È possibile specificare l'elenco di controllo di accesso (ACL) nel descrittore di sicurezza per un'attività per consentire o negare a determinati utenti e gruppi l'accesso a un'attività.
[out] ppTask
Interfaccia
Passare un riferimento a un puntatore a interfaccia NULLIRegisteredTask. Fare riferimento a un puntatore null non può causare una perdita di memoria perché il puntatore verrà sovrascritto.
Valore restituito
Questo metodo può restituire uno di questi valori.
Codice/valore restituito | Descrizione |
---|---|
|
Operazione completata correttamente. |
|
L'accesso viene negato per la connessione al servizio Utilità di pianificazione. |
|
L'applicazione non dispone di memoria sufficiente per completare l'operazione o l'utente o password ha almeno un valore Null e un valore non Null. |
|
L'attività è registrata, ma potrebbe non riuscire ad avviarsi. Il privilegio di accesso batch deve essere abilitato per l'entità attività. |
|
L'attività viene registrata, ma non tutti i trigger specificati avviano l'attività. |
Osservazioni
Per un'attività che contiene un'azione di finestra di messaggio, la finestra di messaggio verrà visualizzata se l'attività è attivata e l'attività ha un tipo di accesso interattivo. Per impostare il tipo di accesso dell'attività in modo interattivo, specificare
Solo un membro del gruppo Administrators può creare un'attività con un trigger di avvio.
È possibile registrare correttamente un'attività con un gruppo specificato nel parametro userId
Il passaggio dei valori TASK_VALIDATE_ONLY e TASK_IGNORE_REGISTRATION_TRIGGERS insieme ai flag di parametro è un argomento non valido.
Se un'attività definisce una rete che non esiste nelle impostazioni
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows Vista [solo app desktop] |
server minimo supportato | Windows Server 2008 [solo app desktop] |
piattaforma di destinazione | Finestre |
intestazione |
taskschd.h |
libreria |
Taskschd.lib |
dll | Taskschd.dll |