IWbemContext::GetNames 方法 (wbemcli.h)
IWbemContext::GetNames 方法返回命名上下文值的所有名称的 SAFEARRAY 结构。 所有名称都已知后,可以对每个名称调用 GetValue 以检索值。 此方法是一种访问上下文值的方法,它不同于调用 BeginEnumeration、 Next 和 EndEnumeration 方法。
语法
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
参数
[in] lFlags
保留。 此参数必须为 0。
[out] pNames
此参数不能为 NULL,但在入口处必须指向 NULL。 如果未返回错误,则退出时 ,pstrNames 将收到指向包含所有上下文值名称VT_BSTR类型的新 SAFEARRAY 结构的指针。 当不再需要数组时,调用方必须在返回的指针上调用 SafeArrayDestroy 。 如果返回错误代码,则指针保持不变。
注意 如果对象中没有命名值,则调用成功并返回长度为 0 的数组。
返回值
此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。
注解
有关使用 BSTR 值的 SAFEARRAY 结构的详细信息,请参阅检索 WMI 实例的一部分。
要求
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wbemcli.h (包括 Wbemidl.h) |
Library | Wbemuuid.lib |
DLL | Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wmipjobj.dll |