WSMAN_PLUGIN_SHUTDOWN función de devolución de llamada (wsman.h)

Define la devolución de llamada de apagado del complemento. Se llama a esta función después de cancelar todas las operaciones y antes de que se descargue el archivo DLL del complemento administración remota de Windows. Todos los complementos winRM deben implementar esta función de devolución de llamada.

El nombre del punto de entrada dll debe ser WSManPluginShutdown.

Sintaxis

WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;

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

Parámetros

pluginContext

Especifica el contexto devuelto por una llamada al método WSManPluginStartup . Este parámetro representa una inicialización de aplicación específica de un complemento WinRM. Se llamará al punto de entrada de apagado para cada aplicación que la inicializó.

flags

Reservado para uso futuro. Debe establecerse en cero.

reason

Especifica el motivo por el que se apaga el complemento.

WSMAN_PLUGIN_SHUTDOWN_SYSTEM

El sistema se apaga.

WSMAN_PLUGIN_SHUTDOWN_SERVICE

El servicio WinRM se apaga.

WSMAN_PLUGIN_SHUTDOWN_IISHOST

El host de IIS se cerró.

Valor devuelto

El método devuelve NO_ERROR si se realizó correctamente; de lo contrario, devuelve un código de error.

Nota Si se produce un error en este método, el complemento no volverá a llamar.

 

Comentarios

Cada llamada correcta a WSManPluginStartup dará lugar a una llamada a esta función antes de que se descargue el archivo DLL del complemento WinRM. Es importante asegurarse de que el complemento WinRM realiza un seguimiento del número de veces que se llama a este punto de entrada de inicio para que el complemento no se apague prematuramente.

Esta función debe asegurarse de que todos los subprocesos del complemento se apaguen antes de que se devuelva. Si el complemento solo controla las operaciones sincrónicas y todos los subprocesos notifican un resultado de cancelación antes de que devuelvan, esta función solo realiza la limpieza del complemento. Sin embargo, para un complemento asincrónico, los subprocesos que se usan para procesar los subprocesos del complemento, incluidos los que acaban de notificar la cancelación de todas las operaciones, deben apagarse completamente. Si no se cierran todos los subprocesos, es posible que se produzcan bloqueos en el archivo DLL porque es posible que el código se ejecute después de descargar el archivo DLL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	wsman.h
Redistribuible	Windows Management Framework en Windows Server 2008 con SP2, y Windows Vista con SP2