Metodo ITask::SetApplicationName (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 . ]
Questo metodo assegna un'applicazione specifica all'attività corrente.
Sintassi
HRESULT SetApplicationName(
[in] LPCWSTR pwszApplicationName
);
Parametri
[in] pwszApplicationName
Stringa con terminazione Null contenente il nome dell'applicazione che verrà associata all'attività. Usare una stringa vuota per cancellare il nome dell'applicazione.
Valore restituito
Il metodo SetApplicationName restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Gli argomenti non sono validi. |
|
Memoria insufficiente. |
Commenti
Se non si specifica un percorso per l'applicazione, l'Utilità di pianificazione cerca il percorso dell'ambiente per trovare il percorso corretto. Se il nome dell'applicazione specifica un programma, il nome deve usare l'estensione .exe per assicurarsi che l'interfaccia utente dell'Utilità di pianificazione visualizzi correttamente l'icona dell'applicazione.
Dopo aver chiamato SetApplicationName, assicurarsi di chiamare IPersistFile::Save per salvare l'attività modificata su disco.
Esempio
Per un esempio di come impostare il nome dell'applicazione, vedere Esempio di codice C/C++: Impostazione del nome dell'applicazione.
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 |