Compartilhar via

WSMAN_PLUGIN_SHUTDOWN função de retorno de chamada (wsman.h)

  • Artigo

Define o retorno de chamada de desligamento para o plug-in. Essa função é chamada depois que todas as operações foram canceladas e antes que a DLL do plug-in de Gerenciamento Remoto do Windows seja descarregada. Todos os plug-ins do WinRM devem implementar essa função de retorno de chamada.

O nome do ponto de entrada da DLL deve ser WSManPluginShutdown.

Sintaxe

WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;

DWORD WsmanPluginShutdown(
  PVOID pluginContext,
  DWORD flags,
  DWORD reason
)
{...}

Parâmetros

pluginContext

Especifica o contexto que foi retornado por uma chamada para o método WSManPluginStartup . Esse parâmetro representa uma inicialização de aplicativo específica de um plug-in WinRM. O ponto de entrada de desligamento será chamado para cada aplicativo que o inicializou.

flags

Reservado para uso futuro. Deve ser definido como zero.

reason

Especifica o motivo pelo qual o plug-in está sendo desligado.

WSMAN_PLUGIN_SHUTDOWN_SYSTEM

O sistema foi desligado.

WSMAN_PLUGIN_SHUTDOWN_SERVICE

O serviço WinRM foi desligado.

WSMAN_PLUGIN_SHUTDOWN_IISHOST

O host do IIS foi desligado.

Retornar valor

O método retornará NO_ERROR se tiver sido bem-sucedido; caso contrário, ele retornará um código de erro.

Nota Se esse método falhar, o plug-in não chamará novamente.
 

Comentários

Cada chamada bem-sucedida para WSManPluginStartup resultará em uma chamada para essa função antes que a DLL do plug-in do WinRM seja descarregada. É importante garantir que o plug-in winRM acompanhe o número de vezes que esse ponto de entrada de inicialização é chamado para que o plug-in não seja desligado prematuramente.

Essa função deve garantir que todos os threads de plug-in sejam desligados antes de retornar. Se o plug-in manipular apenas operações síncronas e todos os threads relatarem um resultado de cancelamento antes de retornarem, essa função executará apenas a limpeza do plug-in. No entanto, para um plug-in assíncrono, todos os threads usados para processar os threads de plug-in, incluindo os que acabaram de relatar o cancelamento para todas as operações, precisam ser completamente desligados. Se todos os threads não forem desligados, podem ocorrer falhas na DLL porque o código pode ser executado depois que a DLL é descarregada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wsman.h
Redistribuível Windows Management Framework no Windows Server 2008 com SP2, e Windows Vista com SP2