QualifierSet_GetNames 函数
检索当前对象或属性中可用的所有限定符或某些限定符的名称。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT QualifierSet_GetNames (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LONG lFlags,
[out] SAFEARRAY (BSTR)** pstrNames
);
参数
vFunc
[in] 未使用此参数。
ptr
[in] 指向 IWbemQualifierSet 实例的指针。
lFlags
[in] 以下标志或值之一，用于指定枚举中要包含的名称。
| 常数 | Value | 说明 |
|---|---|---|
| 0 | 返回所有限定符的名称。 | |
WBEM_FLAG_LOCAL_ONLY |
0x10 | 仅返回特定于当前属性或对象的限定符的名称。 对于属性：仅返回特定于属性的限定符（包括替代），而不是从类定义传播的限定符。 对于实例：仅返回特定于实例的限定符名称。 对于类：仅返回特定于要派生的类的限定符。 |
WBEM_FLAG_PROPAGATED_ONLY |
0x20 | 仅返回从另一个对象传播的限定符的名称。 对于属性：仅返回从类定义传播到此属性的限定符，而不是来自此属性本身的限定符。 对于实例：仅返回从类定义传播的限定符。 对于类：仅返回继承自父类的限定符名称。 |
pstrNames
[out] 一个新的 SAFEARRAY，其中包含请求的名称。 数组可以有 0 个元素。 如果发生错误，则不返回新的 SAFEARRAY。
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的，你也可以在代码中将这些值定义为常数：
| 常数 | Value | 说明 |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数无效。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 内存不足，无法开始新的枚举。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
此函数包装对 IWbemQualifierSet::GetNames 方法的调用。
检索限定符名称后，可以通过调用 QualifierSet_Get 函数按名称访问每个限定符。
给定对象可以具有零个限定符，因此，返回时 pstrNames 中的字符串数可以为 0，即使函数返回 WBEM_S_NO_ERROR 也是如此。
要求
平台：请参阅系统要求。
标头：WMINet_Utils.idl
.NET Framework 版本：自 4.7.2 起可用
