Metodo ITaskFolder::RegisterTaskDefinition (taskschd.h)
Registra (crea) un'attività in una posizione specificata usando l'interfaccia ITaskDefinition per definire un'attività.
Sintassi
HRESULT RegisterTaskDefinition(
[in] BSTR path,
[in] ITaskDefinition *pDefinition,
[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] pDefinition
Definizione dell'attività registrata.
[in] flags
Costante TASK_CREATION .
[in] userId
Credenziali utente usate per registrare l'attività. Se presente, queste credenziali hanno la priorità sulle credenziali specificate nell'oggetto definizione dell'attività a cui punta il parametro pDefinition .
[in] password
Password per l'id utente utilizzato 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
Definisce la tecnica di accesso utilizzata 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 IRegisteredTask che rappresenta la nuova attività.
Passare un riferimento a un puntatore all'interfaccia IRegisteredTaskNULL. Fare riferimento a un puntatore non NULL 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 riuscita. |
|
L'accesso viene negato per connettersi al servizio Utilità di pianificazione. |
|
L'applicazione non dispone di memoria sufficiente per completare l'operazione o l'utente o la 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à. |
Commenti
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à interattivo, specificare TASK_LOGON_INTERACTIVE_TOKEN o TASK_LOGON_GROUP nella proprietà LogonType dell'entità attività oppure nel parametro logonType di ITaskFolder::RegisterTask o ITaskFolder::RegisterTaskDefinition.
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 e TASK_LOGON_INTERACTIVE_TOKEN specificato nel parametro logonType di ITaskFolder::RegisterTask o ITaskFolder::RegisterTaskDefinition, ma l'attività non verrà eseguita.
Il passaggio dei valori TASK_VALIDATE_ONLY e TASK_IGNORE_REGISTRATION_TRIGGERS insieme al parametro flags è un argomento non valido.
Il metodo ITaskFolder::RegisterTaskDefinition restituisce l'errore 80070534 quando viene chiamato dall'account di sistema con il parametro utente uguale a NULL, il parametro password uguale a NULL e il parametro logonType uguale a TASK_LOGON_SERVICE_ACCOUNT.
Se un'attività definisce una rete che non esiste nelle impostazioni NetworkSettings dell'attività, il metodo ITaskFolder::RegisterTaskDefinition restituirà l'errore 0x8000ffff quando l'attività viene registrata.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | taskschd.h |
Libreria | Taskschd.lib |
DLL | Taskschd.dll |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per