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 |