勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces >

IWbemPath

Previous pageReturn to chapter overviewNext page

IWbemPath接口是对象路径解析器的主界面,并以标准方式解析程序可用的路径。此接口是用于设置和检索路径信息的主界面。

 

下表列出了IWbemPath的方法。

 

方法

 

IWbemPath接口继承了IUnknown接口的方法。

 

此外,IWbemPath定义了以下方法。

 

方法

描述

CreateClassPart

初始化路径的类/键部分。

DeleteClassPart

删除路径的类部分。

GetClassName

从路径中检索类名。

GetInfo

返回有关放入解析器对象的路径的详细信息。

GetKeyList

检索IWbemPathKeyList指针,以便可以访问单个密钥。

GetNamespaceAt

根据索引获取命名空间。

GetNamespaceCount

返回路径中的命名空间数。

GetScope

基于索引检索范围。

GetScopeAsText

基于索引检索文本格式的范围。

GetScopeCount

返回路径中的范围数。

GetServer

返回路径的服务器部分。

GetText

返回先前已放入解析器对象的路径的文本表示。

IsLocal

测试传入的计算机名称是否匹配路径中的计算机名称。

IsRelative

测试路径是否相对于特定的计算机和命名空间。

IsRelativeOrChild

测试路径是否相对于特定计算机和命名空间的子节点。

IsSameClassName

测试传入的类名是否匹配路径中的一个。

RemoveAllNamespaces

删除路径的命名空间部分。

RemoveAllScopes

从路径中删除所有范围。

RemoveNamespaceAt

删除特定索引处的命名空间。

RemoveScope

删除基于索引的范围。

SetClassName

设置路径的类名部分。

SetNamespaceAt

根据索引在路径中设置命名空间的值。

SetScope

根据索引在路径中设置范围。

SetScopeFromText

未实现。

SetServer

设置路径的服务器部分。

SetText

解析路径,以便路径解析器可以返回路径上的信息。

 

备注

 

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

 

Windows NT:需要Microsoft .NET Framework SDK。

 

示例代码[C++]

 

以下C ++示例演示如何创建对象路径解析器对象。该代码需要以下#include语句和引用。

 

#define _WIN32_DCOM

#include <comdef.h>

#include <wmiutils.h>

#pragma comment(lib, "wbemuuid.lib")

 

Copy Code

 

IWbemPath *pParser = NULL;

HRESULT hr = NULL;

hr = CoInitializeEx(NULL, COINIT_MULTITHREADED);

hr = CoCreateInstance(CLSID_WbemDefPath,

                    0,

                    CLSCTX_INPROC_SERVER,

                    IID_IWbemPath,

                    (LPVOID *)&pParser);

// -- do something

pParser->Release();

 

要求

 

客户

需要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。