Condividi tramite


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
);

Parametri

[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.

Valore restituito

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.

Requisiti

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

Vedi anche

Itask

ITaskScheduler