返回目录页面

名称空间和环境:英特尔(R) PRO 网络适配器和 WMI 和 CDM Provider 用户指南


CIM 类位于一个名称空间中。标准的 Microsoft* 名称空间称为 root/cimv2;它基于 CIM v2.2 或 root/default。可将 WMI 和 CDM Provider 类添加到此名称空间中。这些 Provider 基于 CIM v2.5。因为这一点,以及对象中关键字的用法的不同,Provider 的类位于一个不同的名称空间 root/IntelNCS 中。

WBEM 环境

环境对象向 Provider 提供不能作为参数传递给 WMI API 方法的额外信息。若要注册环境限定符,使用 IWbemContext 来注册环境限定符。该环境对象的界面指针作为 IWbemServices 方法的最后一个参数传递。

以下表格包含 Provider 使用的环境限定符(命名值)。绝大多数限定符(如 SessionHandle)仅和 Provider 的特定功能范围一同使用;而 LocaleID、MachineName 和 ApplicationName 可为所有 IWbemServices 调用设置。

如果没有环境被传递到 Provider,它们将使用在 Initialize 调用中传递到 Provider 的 LocaleID。任何环境中的读取在写入操作被执行之前,将读取现有配置。随后的读取向系统所显示的信息和在写入操作完成以后的信息一样。NULL 环境可被用于读取。

 
环境限定符 变异类型 说明
SessionHandle VT_BSTR 识别应用程序的 IANet 网络类副本。应用程序在建立会话句柄之前不能更改类或其属性。请参见 IANet_NetService 类部分以了解如何建立和使用会话句柄。如果应用程序将仅从类中读取数据,则不要求此限定符。此会话句柄允许 NCS 软件管理对配置的同时多个会话,而不会导致一个用户将所有其他用户排除在外。每次会话都有一个分开的缓存,用以存储所作的任何更改。如果有多个用户在同时进行更改,则第一个应用其更改的用户将成功。 其他所有用户的缓存将都失效。
LocaleID VT_BSTR Microsoft 的语言地区 ID。如果应用程序向 Provider 要求本地化的文本字符串,则要求此 ID。所有的错误消息和警告将都由英语显示,除非使用要求的 LocaleID。
ApplicationName VT_BSTR 发出调用的应用程序的名称。这是进行记录所要求的。
MachineName VT_BSTR 连接到 Provider 的计算机名称。这是记录日志所要求的。
PreCheck VT_BOOL 此布尔值用以告诉 Provider 以下信息:客户端在执行一项操作之前试图验证是否允许此项操作。例如:向组中添加适配器。

值:

  • TRUE = Provider 将不执行此项操作,但是如果此项操作不允许执行,它将返回一个错误代码以及扩展的状态。
  • FALSE = Provider 将执行操作。

如果限定符丢失,其后果将和属性为 FALSE 时一样。

WarningErrorCode VT_I4 一些操作可能要求将警告发送给用户(例如:在某些情况下向组中添加适配器可能会要求重新载入组)。WMI 不提供这一机制。如果此限定符存在,而且不为零,Provider 将在操作成功后返回 E_FAIL,但是会有一个关联的警告。客户端应该使用扩展的状态来获取警告文本。


请阅读所有限制和免责声明。


返回目录页面 返回页首