WSMAN_PLUGIN_SHUTDOWN回呼函式 (wsman.h)

定義外掛程式的關機回呼。 在取消所有作業之後，以及在卸除 Windows 遠端管理外掛程式 DLL 之前，就會呼叫此函式。 所有 WinRM 外掛程式都必須實作此回呼函式。

DLL 進入點名稱必須是 WSManPluginShutdown。

語法

WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;

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

參數

pluginContext

指定呼叫 WSManPluginStartup 方法所傳回的內容。 此參數代表 WinRM 外掛程式的特定應用程式初始化。 系統會針對初始化它的每個應用程式呼叫關機進入點。

flags

保留供未來使用。 必須設定為零。

reason

指定外掛程式關閉的原因。

WSMAN_PLUGIN_SHUTDOWN_SYSTEM

系統關閉。

WSMAN_PLUGIN_SHUTDOWN_SERVICE

WinRM 服務已關閉。

WSMAN_PLUGIN_SHUTDOWN_IISHOST

IIS 主機關閉。

傳回值

如果成功，此方法會 傳回NO_ERROR ;否則會傳回錯誤碼。

備註

每次成功呼叫 WSManPluginStartup 時，都會在卸除 WinRM 外掛程式 DLL 之前呼叫此函式。 請務必確保 WinRM 外掛程式會追蹤呼叫此啟動進入點的次數，讓外掛程式不會提前關閉。

此函式必須確定所有外掛程式線程都會在傳回之前關閉。 如果外掛程式只會處理同步作業，而且所有線程都會在傳回之前回報取消結果，則此函式只會執行外掛程式清除。 不過，針對異步外掛程式，任何用來處理外掛程式線程的線程，包括只報告所有作業取消的線程，都必須完全關閉。 如果所有線程都未關閉，DLL 中的當機可能會發生，因為程式代碼可能會在 DLL 卸除之後執行。

規格需求