描述
IWbemQualifierSet.GetNames方法检索当前对象或属性中可用的所有限定符的名称。或者，根据IFlags的过滤器值，此方法检索某些限定词的名称。
您可以按名称访问这些限定符，每个名称使用IWbemQualifierSet.Get.任何给定对象都不会有零限定符的错误，所以即使WBEM_S_NO_ERROR返回，返回的pstrNames中的字符串数也可以为0。
C++ 语法
HRESULT GetNames( [in] LONG lFlags, [out] SAFEARRAY (BSTR) **pstrNames ); |
PowerBASIC 语法
METHOD GetNames ( _ BYVAL lFlags AS LONG, _ BYREF pstrNames AS DWORD _ ) AS LONG |
参数
lFlags
以下常数之一。
内容 |
含义 |
0（零） |
返回所有限定词的名称。 |
WBEM_FLAG_LOCAL_ONLY |
仅返回特定于当前属性或对象的限定符的名称。如果当前限定符集合引用一个属性，则只返回特定于属性的限定符（包括覆盖），而不是从类定义传播的限定符。如果当前限定符集合引用一个实例，则只返回特定于实例的限定符名称。如果当前限定词集指的是一个类，则只返回特定于派生类的限定符。 |
WBEM_FLAG_PROPAGATED_ONLY |
仅返回从另一个对象传播的限定词的名称。例如，如果当前限定符集引用一个属性，则只返回从类定义传播到此属性的限定符，而不是返回属性本身的限定符。如果当前限定词集指的是一个实例，则只返回从类定义传播的限定符。如果当前限定词集指的是一个类，则只返回从父类继承的限定词。 |
pstrNames
创建一个新的SAFEARRAY，其中包含请求的名称。
在没有返回错误的情况下，将创建一个新数组，并将pstrNames设置为指向它。即使生成的数组具有零个元素，也会发生这种情况。出现错误时，不会返回新的SAFEARRAY.
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成操作。 |
WBEM_S_NO_ERROR |
通话成功。 |
要求
客户 |
需要Windows Vista，Windows XP，Windows 2000 Professional，Windows NT Workstation 4.0 SP4及更高版本，Windows Me，Windows 98或Windows 95。 |
服务器 |
需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
DLL |
需要Fastprox.dll。 需要Krnlprov.dll。 需要Ncprov.dll。 需要Wbemcore.dll。 |