Funzione AbortSystemShutdownA (winreg.h)

  • Articolo

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

Vedi anche

InitiateSystemShutdown

Arresto

Funzioni di arresto del sistema