GetNamespaceAt 方法

描述

IWbemPath.GetNamespaceAt方法根据其索引检索命名空间。路径中最左侧的命名空间的索引为0，每个命名空间向右移动，索引值逐渐升高。

C++ 语法

HRESULT GetNamespaceAt(

[in] ULONG uIndex,

[in, out] ULONG *puNameBufLength,

[in, out] LPWSTR pName

);

PowerBASIC 语法

METHOD GetNamespaceAt ( _

BYVAL uIndex AS DWORD, _

BYREF puNameBufLength AS DWORD, _

BYREF pName AS WSTRINGZ _

) AS LONG

参数

uIndex

要读取的命名空间的索引。路径中最左侧的命名空间是索引0，右侧的每个命名空间具有逐渐更高的索引值。最大允许值小于当前命名空间数。

puNameBufLength

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

pName

命名空间名称。

返回值

此方法返回以下值之一。

退货代码

描述

S_OK

方法成功执行

WBEM_E_INVALID_PARAMETER

表示以下三个条件之一：

·	puNameBufLength参数为NULL。

·	puNameBufLength参数表示非零长度缓冲区，但缓冲区为NULL。

索引值超出范围。

WBEM_E_OUT_OF_MEMORY

内存不足。

备注

该方法可用于确定pName需要多大的缓冲区。这通过传递缓冲区的NULL指针来完成，将puNameBufLength设置为0，然后进行调用。返回时，puNameBufLength指示pName及其终止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。