WSMAN_PLUGIN_STARTUP回呼函式 (wsman.h)

定義外掛程式的啟動回呼。 因為多個應用程式可以裝載在同一個進程中，所以這個方法可以多次呼叫，但每個應用程式初始化只能呼叫一次。 外掛程式可以在相同的進程中多次初始化，但每個 applicationIdentification 值只能初始化一次。 從這個方法傳回的內容應該是應用程式特定的。 傳回的內容將會傳遞至應用程式專屬的所有未來外掛程式呼叫。 所有 Windows 遠端管理 (WinRM) 外掛程式都必須實作此回呼函式。

這個方法的 DLL 進入點名稱必須是 WSManPluginStartup。

語法

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

DWORD WsmanPluginStartup(
  DWORD flags,
  PCWSTR applicationIdentification,
  PCWSTR extraInfo,
  PVOID *pluginContext
)
{...}

參數

flags

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

applicationIdentification

裝載應用程式的唯一標識碼。 針對主要 WinRM 服務，預設值為 wsman。 對於 Internet Information Services (IIS) 主機，此標識符與該主機的應用程式端點相關。 例如， wsman/MyCompany/MyApplication。

extraInfo

包含組態資訊的字串，如果註冊外掛程式時儲存任何資訊。 使用 WinRM 組態註冊外掛程式時，外掛程式可以在初始化期間新增額外的組態參數，以在初始化至選擇性節點時很有用。 如果在不同的 IIS 裝載案例中使用外掛程式，而且在初始化期間需要稍微不同的運行時間語意，這項資訊就特別有用。 如果組態存在，則此字串是 XML 的複本。 否則，此參數會設定為 NULL。

pluginContext

特定應用程式初始化的內容。 此內容會傳遞至與此 applicationIdentifier 相關聯的所有其他 WinRM 外掛程式呼叫。

傳回值

如果方法成功，則會傳回 NO_ERROR ;否則，它會傳回錯誤碼。 如果此方法傳回錯誤，將不會呼叫 WSManPluginShutdown 進入點。

規格需求

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