Metodo ITaskScheduler::Activate (mstask.h)

[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]

Il metodo Activate restituisce un'interfaccia attiva per un elemento di lavoro specificato.

Sintassi

HRESULT Activate(
  [in]  LPCWSTR  pwszName,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnk
);

[in] pwszName

Stringa con terminazione Null che specifica il nome dell'elemento di lavoro da attivare.

[in] riid

Identificatore che identifica l'interfaccia richiesta. L'unica interfaccia supportata in questo momento, ITask, ha l'identificatore IID_ITask.

[out] ppUnk

Puntatore a un puntatore di interfaccia che riceve l'indirizzo dell'interfaccia richiesta.

Quando questo metodo ha esito positivo, viene restituito S_OK.

Se il metodo ha esito negativo, potrebbe essere restituito uno dei codici di errore seguenti.

Codice restituito	Descrizione
COR_E_FILENOTFOUND	L'attività non esiste.
E_INVALIDARG	Il parametro pwszName non è valido.
E_OUTOFMEMORY	Allocazione di memoria non riuscita.
SCHED_E_UNKNOWN_OBJECT_VERSION	La versione dell'oggetto attività non è supportata o non è valida.

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mstask.h
Libreria	Mstask.lib
DLL	Mstask.dll
Componente ridistribuibile	Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95