IWbemQualifierSet::GetNames 方法 (wbemcli.h)
IWbemQualifierSet::GetNames 方法检索当前对象或属性中所有可用限定符的名称。 或者,根据 IFlags 的筛选器值,此方法检索某些限定符的名称。
可以按名称访问这些限定符,对每个名称使用 IWbemQualifierSet::Get 。 任何给定对象的限定符为零都不是错误,因此返回时 pstrNames 中的字符串数可以为 0,即使 WBEM_S_NO_ERROR 返回也是如此。
语法
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
参数
[in] lFlags
以下常量之一。
0 (零)
返回所有限定符的名称。
WBEM_FLAG_LOCAL_ONLY
仅返回特定于当前属性或对象的限定符的名称。 如果当前限定符集引用属性,则仅返回特定于属性的限定符 (包括替代) ,而不返回从类定义传播的限定符。 如果当前限定符集引用实例,则仅返回特定于实例的限定符名称。 如果当前限定符集引用类,则仅返回特定于所派生类的限定符。
WBEM_FLAG_PROPAGATED_ONLY
仅返回从另一个对象传播的限定符的名称。 例如,如果当前限定符集引用属性,则仅返回从类定义传播到此属性的限定符,而不返回属性本身的限定符。 如果当前限定符集引用实例,则仅返回从类定义传播的那些限定符。 如果当前限定符集引用类,则仅返回从父类继承的那些限定符名称。
[out] pNames
将创建一个新的 SAFEARRAY ,其中包含请求的名称。
在所有未返回错误的情况下,都会创建一个新数组,并将 pstrNames 设置为指向它。 即使生成的数组包含零个元素,也会发生这种情况。 出错时,不会返回新的 SAFEARRAY 。
返回值
此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。
注解
有关使用 BSTR的 SAFEARRAY的示例,请参阅检索 WMI 实例的一部分。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wbemcli.h (包括 Wbemidl.h) |
Library | Wbemuuid.lib |
DLL | Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll |