IWSManSession::Create 方法 (wsmandisp.h)
创建资源的新实例,并返回新 对象的终结点 引用 (EPR) 。
语法
HRESULT Create(
[in] VARIANT resourceUri,
[in] BSTR resource,
[in] long flags,
[out] BSTR *newUri
);
参数
[in] resourceUri
要创建的资源的标识符。
此参数可以包含以下项之一:
- 具有一个或多个 选择器的 URI。 请注意, WMI 插件 不支持创建除 WS-Management 协议侦听器以外的任何资源。
- 可能包含选择器、片段或选项的ResourceLocator 对象。
- WS-Addressing 终结点参考,如 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 |
Library | WSManDisp.tlb |
DLL | WSMAuto.dll |