GetScope 方法

描述

IWbemPath.GetScope方法基于索引检索范围。对于Windows XP，索引必须为0（零），范围是路径的类或键部分。该方法检索类名和IWbemPathKeyList指针，以便可以检索密钥的详细信息。

C++ 语法

HRESULT GetScope(

[in] ULONG uIndex,

[in, out] ULONG *puClassNameBufSize,

[out] LPWSTR pszClass,

[out] IWbemPathKeyList **pKeyList

);

PowerBASIC 语法

METHOD GetScope ( _

BYVAL uIndex AS DWORD, _

BYREF puClassNameBufSize AS DWORD, _

BYREF pszClass AS WSTRINGZ, _

BYREF pKeyList AS IWbemPathKeyList _

) AS LONG

参数

uIndex

范围索引。

puClassNameBufSize

来电者将此设置为缓冲区可以容纳的字符数。成功后，将其设置为复制到包含NULL终止符的缓冲区中的字符数。

pszClass

要复制范围的缓冲区。

pKeyList

指向IWbemPathKeyList对象。

返回值

此方法返回以下值之一。

退货代码

描述

S_OK

方法成功执行

WBEM_E_BUFFER_TOO_SMALL

缓冲区不够大

WBEM_E_INVALID_PARAMETER

表示以下三个条件之一：

·	puClassNameBufSize参数为NULL。

·	puClassNameBufSize表示非零长度缓冲区，但缓冲区为NULL。

索引值超出范围。

WBEM_E_OUT_OF_MEMORY

内存不足以执行此方法。

备注

他的方法可以用于确定pszClass需要多大的缓冲区。这是通过传递缓冲区的NULL指针，将puClassNameBufSize设置为0，然后进行调用。返回时，puClassNameBufSize指示pszClass及其终止NULL字符需要多大的缓冲区。

Windows 2000 / NT：需要WMI SDK Update或Microsoft .NET Framework SDK。

Windows NT：需要Microsoft .NET Framework SDK。

要求

客户	需要Windows Vista或Windows XP。
服务器	需要Windows Server 2008或Windows Server 2003。
可再发行	需要Windows 2000和Windows NT上的WMI可重新分发组件版本1.0。在Windows NT上，它也需要Microsoft .NET Framework。
头	在Wmiutils.inc中声明。
DLL	需要Wmiutils.dll。