WSMAN_PLUGIN_SHUTDOWN funzione di callback (wsman.h)
Definisce il callback di arresto per il plug-in. Questa funzione viene chiamata dopo che tutte le operazioni sono state annullate e prima che la DLL di gestione remota di Windows venga scaricata. Tutti i plug-in WinRM devono implementare questa funzione di callback.
Il nome del punto di ingresso della DLL deve essere WSManPluginShutdown.
Sintassi
WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;
DWORD WsmanPluginShutdown(
PVOID pluginContext,
DWORD flags,
DWORD reason
)
{...}
Parametri
pluginContext
Specifica il contesto restituito da una chiamata al metodo WSManPluginStartup . Questo parametro rappresenta un'inizializzazione specifica dell'applicazione di un plug-in WinRM. Il punto di ingresso di arresto verrà chiamato per ogni applicazione che l'ha inizializzata.
flags
Riservato per utilizzi futuri. Deve essere impostato su zero.
reason
Specifica il motivo per cui il plug-in viene arrestato.
WSMAN_PLUGIN_SHUTDOWN_SYSTEM
Il sistema viene arrestato.
WSMAN_PLUGIN_SHUTDOWN_SERVICE
Il servizio WinRM viene arrestato.
WSMAN_PLUGIN_SHUTDOWN_IISHOST
L'host IIS viene arrestato.
Valore restituito
Il metodo restituisce NO_ERROR se ha esito positivo; in caso contrario, restituisce un codice di errore.
Commenti
Ogni chiamata riuscita a WSManPluginStartup genera una chiamata a questa funzione prima che la DLL del plug-in WinRM venga scaricata. È importante assicurarsi che il plug-in WinRM tiene traccia del numero di volte in cui questo punto di ingresso di avvio viene chiamato in modo che il plug-in non venga arrestato prematuramente.
Questa funzione deve assicurarsi che tutti i thread plug-in vengano arrestati prima che vengano restituiti. Se il plug-in gestisce solo operazioni sincrone e tutti i thread segnalano un risultato di annullamento prima di restituire, questa funzione esegue solo la pulizia plug-in. Tuttavia, per un plug-in asincrono, tutti i thread usati per elaborare i thread plug-in, inclusi quelli che hanno appena segnalato l'annullamento per tutte le operazioni, devono essere completamente arrestati. Se tutti i thread non vengono arrestati, potrebbero verificarsi arresti anomali nella DLL perché il codice potrebbe essere eseguito dopo il caricamento della DLL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 7 |
Server minimo supportato | Windows Server 2008 R2 |
Piattaforma di destinazione | Windows |
Intestazione | wsman.h |
Componente ridistribuibile | Windows Management Framework in Windows Server 2008 con SP2, e Windows Vista con SP2 |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per