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 。 如果返回错误代码，则指针保持不变。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。

注解

有关使用 BSTR 值的 SAFEARRAY 结构的详细信息，请参阅检索 WMI 实例的一部分。

要求

另请参阅

IWbemContext

IWbemContext：：BeginEnumeration

IWbemContext：：GetValue