IWbemContext::GetNames 方法 (wbemcli.h)

IWbemContext::GetNames 方法返回命名上下文值的所有名称的 SAFEARRAY 结构。 所有名称都已知后,可以对每个名称调用 GetValue 以检索值。 此方法是一种访问上下文值的方法,它不同于调用 BeginEnumerationNextEndEnumeration 方法。

语法

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

另请参阅

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue