WSMAN_PLUGIN_SHUTDOWN funzione di callback (wsman.h)

Articolo
03/04/2024

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.

Nota Se questo metodo ha esito negativo, il plug-in non verrà richiamato.

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

Condividi tramite