QualifierSet_Put 函数
写入命名限定符和值。 新的限定符将覆盖同名的上一个值。 如果限定符不存在，则会创建一个。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT QualifierSet_Put (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LPCWSTR wszName,
[in] VARIANT* pVal,
[in] LONG lFlavor
);
参数
vFunc
[in] 未使用此参数。
ptr
[in] 指向 IWbemQualifierSet 实例的指针。
wszName
[in] 要写入的限定符的名称。
pVal
[in] 指向包含要写入的限定符的有效 VARIANT 的指针。 此参数不能为 null。
lFlavor
[in] 以下常数之一，用于定义此限定符所需的限定符风格。 默认值为 WBEM_FLAVOR_OVERRIDABLE (0)。
| 常数 | Value | 说明 |
|---|---|---|
WBEM_FLAVOR_OVERRIDABLE |
0 | 可以在派生类或实例中重写限定符。 这是默认值。 |
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE |
1 | 限定符传播到实例。 |
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS |
2 | 限定符传播到派生类。 |
WBEM_FLAVOR_NOT_OVERRIDABLE |
0x10 | 不能在派生类或实例中重写限定符。 |
WBEM_FLAVOR_AMENDED |
0x80 | 限定符已本地化。 |
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的，你也可以在代码中将这些值定义为常数：
| 常数 | Value | 说明 |
|---|---|---|
WBEM_E_CANNOT_BE_KEY |
0x8004101f | 此处存在非法尝试，即在不能为键的属性上指定键限定符。 键可以在对象的类定义中指定，但不能在每个实例基础上更改。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数无效。 |
WBEM_E_INVALID_QUALIFIER_TYPE |
0x80041029 | pVal 参数的限定符类型不合法。 |
WBEM_E_OVERRIDE_NOT_ALLOWED |
0x8004101a | 无法在限定符上调用 QualifierSet_Put 方法，因为所属对象不允许重写。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
此函数包装对 IWbemQualifierSet::Put 方法的调用。
要求
平台：请参阅系统要求。
标头：WMINet_Utils.idl
.NET Framework 版本：自 4.7.2 起可用
