Método ITaskScheduler::SetTargetComputer (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 SetTargetComputer selecciona el equipo en el que funciona la interfaz ITaskScheduler , lo que permite la administración y enumeración de tareas remotas.

Sintaxis

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

Parámetros

[in] pwszComputer

Puntero a una cadena de caracteres anchos terminada en NULL que especifica el nombre del equipo de destino para la instancia actual de la interfaz ITaskScheduler . Especifique el nombre del equipo de destino en el formato Convención de nomenclatura universal (UNC). Para indicar el equipo local, establezca este valor en NULL o en el nombre UNC del equipo local.

Nota Al especificar un nombre de equipo remoto, use dos caracteres de barra diagonal inversa (\\) antes del nombre del equipo. Por ejemplo, use "\\NombreDeEquipo" en lugar de "NombreDeEquipo".

 

Valor devuelto

El método SetTargetComputer devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
SCHED_E_SERVICE_NOT_INSTALLED	El servicio Programador de tareas no está instalado en el equipo de destino.
E_ACCESS_DENIED	El usuario no tiene acceso al equipo remoto.
E_INVALIDARG	El parámetro pwszComputer no es válido.
E_OUTOFMEMORY	Error de asignación de memoria.

Comentarios

Para que un equipo Con Windows Server 2003, Windows XP cree, supervise o controle tareas en un equipo Windows Vista, se deben completar las siguientes operaciones en el equipo Windows Vista y el usuario que llama al método ITaskScheduler::SetTargetComputer debe ser miembro del grupo Administradores en el equipo remoto de Windows Vista.

Habilitar la excepción "Compartir archivos e impresoras" en firewall de Windows

1. Haga clic en Inicio y, a continuación, en Panel de control.
2. En Panel de control, haga clic en Vista clásica y, a continuación, haga doble clic en el icono Firewall de Windows.
3. En la ventana Firewall de Windows, haga clic en la pestaña Excepciones y active la casilla Excepción De uso compartido de archivos e impresoras .

Habilitación del servicio "Registro remoto"

• Abra una ventana del símbolo del sistema y escriba el siguiente comando: net start "Remote Registry"

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mstask.h
Library	Mstask.lib
Archivo DLL	Mstask.dll

Consulte también

ITaskScheduler