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 informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Le funzioni InitiateSystemShutdown e InitiateSystemShutdownEx visualizzano una finestra di dialogo che notifica all'utente che il sistema sta arrestando. Durante il periodo di timeout dell'arresto, la funzione AbortSystemShutdown può impedire all'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 agli utenti che informano che il server non viene più arrestato.
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 di SE_SHUTDOWN_NAME nel computer in cui sono connessi e gli amministratori possono abilitare il privilegio di 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.
Esempio
Per un esempio, vedere Visualizzazione della finestra di dialogo Arresta.
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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winreg.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |