IWSManSession：：Create 方法 (wsmandisp.h)

建立資源的新實例，並傳回新物件的 EPR (EPR) 端點 參考 。

語法

HRESULT Create(
  [in]  VARIANT resourceUri,
  [in]  BSTR    resource,
  [in]  long    flags,
  [out] BSTR    *newUri
);

參數

[in] resourceUri

要建立之資源的標識碼。

此參數可以包含下列其中一項：

• 具有一或多個 選取器的 URI。 請注意， WMI 外掛程式 不支援建立 WS-Management 通訊協定接聽程式以外的任何資源。
• ResourceLocator 物件，可能包含選取器、 片段或 選項。
• WS 位址 端點參考，如 WS-Management 通訊協定標準中所述。 如需 WS-Management 通訊協定公用規格的詳細資訊，請參閱 管理規格索引頁面。

[in] resource

包含資源內容的 XML 字串。

[in] flags

保留的。 必須設定為 0。

[out] newUri

新資源的 EPR。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

IWSManSession：：Create 僅用於建立資源的新實例。 使用 IWSManSession：:P ut 方法來更新資源的現有實例。 取得新的資源 URI 之後，您可以呼叫 IWSManSession：：Get 來擷取新的物件。 新的物件包含資源提供者在建立新物件時指派的任何屬性。 例如，如果您建立新的 WS-Management 通訊協定接聽程式 ，並使用 Session.Get 擷取接聽程序物件，則也會取得 Port、 Enabled 和 ListeningOn 屬性。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wsmandisp.h
程式庫	WSManDisp.tlb
Dll	WSMAuto.dll

另請參閱

IWSManSession

Session.Create