Funzione InitiateShutdownW (winreg.h)

Avvia un arresto e il riavvio del computer specificato e riavvia tutte le applicazioni registrate per il riavvio.

Sintassi

DWORD InitiateShutdownW(
  [in, optional] LPWSTR lpMachineName,
  [in, optional] LPWSTR lpMessage,
  [in]           DWORD  dwGracePeriod,
  [in]           DWORD  dwShutdownFlags,
  [in]           DWORD  dwReason
);

Parametri

[in, optional] lpMachineName

Nome del computer da arrestare. Se il valore di questo parametro è NULL, il computer locale viene arrestato.

[in, optional] lpMessage

Messaggio da visualizzare nella finestra di dialogo di arresto interattivo.

[in] dwGracePeriod

Numero di secondi di attesa prima dell'arresto del computer. Se il valore di questo parametro è zero, il computer viene arrestato immediatamente. Questo valore è limitato alle MAX_SHUTDOWN_TIMEOUT.

Se il valore di questo parametro è maggiore di zero e il parametro dwShutdownFlags specifica il flag SHUTDOWN_GRACE_OVERRIDE, la funzione ha esito negativo e restituisce il codice di errore ERROR_BAD_ARGUMENTS.

[in] dwShutdownFlags

Uno o più flag di bit che specificano le opzioni per l'arresto. Vengono definiti i valori seguenti.

[in] dwReason

Motivo dell'avvio dell'arresto. Questo parametro deve essere uno dei codici motivo di arresto del sistema. Se questo parametro è zero, il valore predefinito è un arresto non definito registrato come "Impossibile trovare il titolo per questo motivo". Per impostazione predefinita, è anche un arresto non pianificato. A seconda della configurazione del sistema, un arresto non pianificato attiva la creazione di un file contenente le informazioni sullo stato del sistema, che può ritardare l'arresto. Pertanto, non usare zero per questo parametro.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.

Commenti

Per arrestare il computer locale, il thread chiamante deve avere il privilegio SE_SHUTDOWN_NAME. Per arrestare un computer remoto, il thread chiamante deve avere il privilegio di 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 o inaccessibile o privilegi insufficienti. L'errore ERROR_SHUTDOWN_IN_PROGRESS viene restituito se un arresto è già in corso nel computer specificato. L'errore ERROR_NOT_READY può essere restituito se il passaggio rapido dell'utente è abilitato ma non è connesso alcun utente.

Un valore restituito diverso da zero non indica che la disconnessione è stata o avrà esito positivo. L'arresto è un processo asincrono e può verificarsi molto tempo dopo la restituzione o meno della chiamata API. Anche se il valore di timeout è zero, l'arresto può comunque essere interrotto da applicazioni, servizi o persino dal sistema. Il valore restituito diverso da zero indica che la convalida dei diritti e dei parametri ha avuto esito positivo e che il sistema ha accettato la richiesta di arresto.

Requisiti

Vedi anche

Arresto