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 中包含的值。

注解

有关使用 BSTRSAFEARRAY的示例,请参阅检索 WMI 实例的一部分

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll

另请参阅

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get