Funzione AbortSystemShutdownA (winreg.h)
Arresta un arresto del sistema avviato.
Sintassi
BOOL AbortSystemShutdownA(
[in, optional] LPSTR lpMachineName
);
Parametri
[in, optional] lpMachineName
Nome di rete del computer in cui deve essere arrestato l'arresto. Se lpMachineName è NULL o una stringa vuota, la funzione arresta l'arresto nel computer locale.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Le funzioni InitiateSystemShutdown e InitiateSystemShutdownEx visualizzano una finestra di dialogo che informa l'utente che il sistema sta arrestando. Durante il periodo di timeout dell'arresto, la funzione AbortSystemShutdown può impedire l'arresto del sistema.
Windows Server 2003 e Windows XP con SP1: Se il computer da arrestare è un server Servizi terminal, il sistema visualizza una finestra di dialogo per tutti gli utenti locali e remoti che avvisano che l'arresto è stato avviato. Se l'arresto viene impedito da AbortSystemShutdown, il sistema visualizza la finestra di dialogo per informare gli utenti che il server non sta più arrestando.
Per arrestare il computer locale, il processo chiamante deve avere il privilegio SE_SHUTDOWN_NAME. Per arrestare un computer remoto, il processo chiamante deve avere il privilegio SE_REMOTE_SHUTDOWN_NAME nel computer remoto. Per impostazione predefinita, gli utenti possono abilitare il privilegio SE_SHUTDOWN_NAME nel computer in cui sono connessi e gli amministratori possono abilitare il privilegio SE_REMOTE_SHUTDOWN_NAME nei computer remoti. Per altre informazioni, vedere esecuzione con privilegi speciali.
I motivi comuni dell'errore includono un nome computer non valido, un computer inaccessibile o privilegi insufficienti.
Esempi
Per un esempio, vedere Visualizzazione della finestra di dialogo Arresto.
Nota
L'intestazione winreg.h definisce AbortSystemShutdown come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [app desktop | App UWP] |
| server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| piattaforma di destinazione | Finestre |
| intestazione |
winreg.h (include Windows.h) |
| libreria |
Advapi32.lib |
| dll | Advapi32.dll |