描述
IWbemContext.GetNames方法返回一个SAFEARRAY结构的所有名称的上下文值。所有的名字都知道后，可以在每个名称上调用GetValue来检索该值。这种技术是访问与调用BeginEnumeration，下一个和EndEnumeration方法不同的上下文值的一种方法。
C++ 语法
HRESULT GetNames( [in] LONG lFlags, [out] SAFEARRAY (BSTR) **pNames ); |
PowerBASIC 语法
METHOD GetNames ( _ BYVAL lFlags AS LONG, _ BYREF pNames AS DWORD _ ) AS LONG |
参数
lFlags
保留。该参数必须为0。
pNames
此参数不能为NULL，但在入口时它必须指向NULL。如果没有返回错误，在退出pstrNames接收到一个指向类型为VT_BSTR的新的SAFEARRAY结构的指针，其中包含所有上下文值名称。当不再需要阵列时，调用者必须在返回的指针上调用SafeArrayDestroy.如果返回错误代码，则指针不被修改。
注意如果对象中没有命名值，则调用成功并返回长度为0的数组。
返回值
此方法返回一个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 |
需要Esscli.dll。 需要Fastprox.dll。 需要Framedyn.dll。 需要Wbemcomn.dll。 需要Wbemcore.dll。 需要Wbemess.dll。 需要Wmipjobj.dll。 |