Método ITaskScheduler::Activate (mstask.h)

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o del producto. Use las interfaces del Programador de tareas 2.0 en su lugar. ]

El método Activate devuelve una interfaz activa para un elemento de trabajo especificado.

Sintaxis

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

Parámetros

[in] pwszName

Cadena terminada en null que especifica el nombre del elemento de trabajo que se va a activar.

[in] riid

Identificador que identifica la interfaz que se solicita. La única interfaz admitida en este momento, ITask, tiene el identificador IID_ITask.

[out] ppUnk

Puntero a un puntero de interfaz que recibe la dirección de la interfaz solicitada.

Valor devuelto

Cuando este método se realiza correctamente, se devuelve S_OK.

Si se produce un error en el método, se puede devolver uno de los siguientes códigos de error.

Código devuelto	Descripción
COR_E_FILENOTFOUND	La tarea no existe.
E_INVALIDARG	El parámetro pwszName no es válido.
E_OUTOFMEMORY	Error en la asignación de memoria.
SCHED_E_UNKNOWN_OBJECT_VERSION	La versión del objeto de tarea no es compatible o no es válida.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mstask.h
Library	Mstask.lib
Archivo DLL	Mstask.dll
Redistribuible	Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95

Consulte también

ITask

ITaskScheduler