大网数据广告活动
.NET 与 C# 开发

GetNames 函数 (非托管 API 参考)

· 52CE 我爱测

GetNames 函数检索的对象的属性的名称。

检索对象属性的子集或所有名称。

Note: 此 API 仅供内部使用。 不应从开发人员代码中使用。

语法

HRESULT GetNames (
   [in] int                 vFunc, 
   [in] IWbemClassObject*   ptr, 
   [in] LPCWSTR             wszQualifierName,
   [in] LONG                lFlags,
   [in] VARIANT*            pQualifierValue,
   [out] SAFEARRAY (BSTR)** pstrNames
); 

参数

vFunc
[in]此参数是未使用。

ptr
[in]一个指向IWbemClassObject实例。

wszQualifierName
[in]指向一个有效的指针LPCWSTR,指定作为筛选器的一部分进行操作的限定符名称。 有关详细信息,请参阅备注部分。 此参数可以为 null。

lFlags
[in]位域的组合。 有关详细信息,请参阅备注部分。

pQualifierValue
[in]指向一个有效的指针VARIANT结构初始化为一个筛选器值。 此参数可以为 null。

pstrNames
[out]一个SAFEARRAY结构,其中包含属性名称。 在进入时,此参数必须始终为一个指向null。 请参阅备注部分,了解详细信息。

返回值

此函数返回以下值中定义WbemCli.h标头文件,也可以在定义它们为常量在代码中:

返回的常量 值 描述
WBEM_E_FAILED 0x80041001 已存在时的常见错误。
WBEM_E_INVALID_PARAMETER 0x80041008 一个或多个参数无效,或者指定了不正确的标志和参数组合。
WBEM_E_OUT_OF_MEMORY 0x80041006 没有足够的内存是可用于完成该操作。
WBEM_S_NO_ERROR 0 函数调用成功。

备注

此函数包装对的调用IWbemClassObject::GetNames方法。

由组合的标志和参数控制返回的命名。 例如,该函数可以返回所有属性的名称或键属性的名称。 中指定主要筛选器lFlags参数,并使用其他参数不同,具体取决于它。

中的标志值lFlags是位域

可以作为传递的标志lEnumFlags自变量是在中定义的位域WbemCli.h标头文件,也可以在定义它们为常量在代码中。 可以结合任何其他组中的任何标志每个组中的一个标志。 但是,在同一组中的标志是互斥的。

组 1 标志 值 Description
WBEM_FLAG_ALWAYS 0 返回所有属性名称。 strQualifierName 和pQualifierVal未使用。
WBEM_FLAG_ONLY_IF_TRUE 1 返回具有指定的名称的限定符的唯一属性strQualifierName参数。 如果使用此标志,则必须指定strQualifierName。
WBEM_FLAG_ONLY_IF_FALSE 2 返回不具有指定的名称的限定符的唯一属性strQualifierName参数。 如果使用此标志,则必须指定strQualifierName。
WBEM_FLAG_ONLY_IF_IDENTICAL 3 返回具有指定的名称的限定符的属性wszQualifierName参数和也有值与指定的相同pQualifierVal结构。 如果使用此标志,则必须指定这两wszQualifierName和一个pQualifierValue。
组 2 标志 值 描述
WBEM_FLAG_KEYS_ONLY 0x4 返回定义的键的属性的名称。
WBEM_FLAG_REFS_ONLY 0x8 返回唯一属性名称的对象引用。
组 3 标志 值 描述
WBEM_FLAG_LOCAL_ONLY 0x10 返回属于派生程度最高的类的属性名称。 从父类中排除的属性。
WBEM_FLAG_PROPAGATED_ONLY 0x20 返回属于父类的属性名称。
WBEM_FLAG_SYSTEM_ONLY 0x30 返回系统属性的名称。
WBEM_FLAG_NONSYSTEM_ONLY 0x40 返回仅非系统属性的名称。

该函数始终会分配一个新SAFEARRAY如果它返回WBEM_S_NO_ERROR,和pstrNames始终设置为指向它。 如果没有属性与指定筛选器匹配,则返回的数组可以有 0 个元素。 如果该函数将返回一个值,而不WBM_S_NO_ERROR,新SAFEARRAY结构,则不返回。

要求

平台: 请参阅系统需求。

标头: WMINet_Utils.idl

.NET Framework 版本: 自 4.7.2 之后可用

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 11/06/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。