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

另请参阅

IWSManSession

Session.Create