共用方式為

WSMAN_PLUGIN_SHELL回呼函式 (wsman.h)

  • 發行項

定義外掛程式的殼層回呼。 收到新殼層的要求時，會呼叫此函式。 支援殼層作業的所有 Windows 遠端管理外掛程式都需要實作此回呼。

DLL 進入點名稱必須是 WSManPluginShell。

語法

WSMAN_PLUGIN_SHELL WsmanPluginShell;

void WsmanPluginShell(
  PVOID pluginContext,
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  WSMAN_SHELL_STARTUP_INFO *startupInfo,
  WSMAN_DATA *inboundShellInformation
)
{...}

參數

pluginContext

指定呼叫 WSManPluginStartup 方法所傳回的內容。 此參數代表 WinRM 外掛程式的特定應用程式初始化。

requestDetails

WSMAN_PLUGIN_REQUEST 結構的指標，指定要求的資源 URI、選項、地區設定、關機旗標和句柄。

flags

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

startupInfo

包含殼層啟動資訊的 WSMAN_SHELL_STARTUP_INFO 結構的指標。

inboundShellInformation

WSMAN_DATA 結構的指標，指定包含殼層額外數據的選擇性輸入物件。

傳回值

無

備註

WinRM (WinRM) 外掛程式會呼叫 WSManPluginReportContext ，以註冊殼層的殼層內容。 此殼層上的所有作業都會傳入此內容。 如果殼層已關閉或外掛程式會檢查 requestDetails 參數，並報告作業已取消，外掛程式應該呼叫 WSManPluginOperationComplete。 傳入的所有參數都是有效的，直到 WinRM 外掛程式呼叫 WSManPluginOperationComplete 為止。

規格需求

需求 值
最低支援的用戶端 Windows 7
最低支援的伺服器 Windows Server 2008 R2
目標平台 Windows
標頭 wsman.h
可轉散發套件 在 Windows Server 2008 上使用 SP2、Windows Vista sp1 和 Windows Vista SP2 上的 Windows Management Framework