Método ITask::SetApplicationName (mstask.h)
[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o producto. Use en su lugar las interfaces del Programador de tareas 2.0 . ]
Este método asigna una aplicación específica a la tarea actual.
Sintaxis
HRESULT SetApplicationName(
[in] LPCWSTR pwszApplicationName
);
Parámetros
[in] pwszApplicationName
Cadena terminada en null que contiene el nombre de la aplicación que se asociará a la tarea. Use una cadena vacía para borrar el nombre de la aplicación.
Valor devuelto
El método SetApplicationName devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
Los argumentos no son válidos. |
|
No hay suficiente memoria disponible. |
Comentarios
Si no especifica una ruta de acceso para la aplicación, el Programador de tareas busca en la ruta de acceso del entorno para encontrar la ruta de acceso correcta. Si el nombre de la aplicación especifica un programa, el nombre debe usar la extensión .exe para asegurarse de que la interfaz de usuario del Programador de tareas muestra correctamente el icono de la aplicación.
Después de llamar a SetApplicationName, asegúrese de llamar a IPersistFile::Save para guardar la tarea modificada en el disco.
Ejemplos
Para obtener un ejemplo de cómo establecer el nombre de la aplicación, vea Ejemplo de código de C/C++: Establecer el nombre de la aplicación.
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 |