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

Parse Method

Previous pageReturn to chapter overviewNext page

描述

 

IWbemQuery.Parse方法解析查询字符串。

 

C++ 语法

 

HRESULT Parse(

[in]  LPCWSTR pszLang,

[in]  LPCWSTR pszQuery,

[in]  ULONG uFlags

);

 

PowerBASIC 语法

 

METHOD Parse ( _

BYREF pszLang AS WSTRINGZ, _

BYREF pszQuery AS WSTRINGZ, _

BYVAL uFlags AS DWORD _

) AS LONG

 

参数

 

pszLang

 

查询语言必须是“WQL”或“SQL”(区分大小写)。任何其他值都会导致方法失败,并返回WBEM_E_INVALID_PARAMETER。

 

pszQuery

 

有效的WQL或SQL WMI查询。

 

uFlags

 

留作将来使用。必须为0(零)。

 

返回值

 

此方法返回一个HRESULT,指示方法调用的状态。

 

退货代码

描述

WBEM_S_NO_ERROR

方法成功分析查询。

WBEM_E_INVALID_PARAMETER

呼叫的参数之一是不正确的。

WBEM_E_INVALID_SYNTAX

该查询在语法上无效。

 

示例代码

 

以下代码示例显示了使用IWbemQuery.Parse.

 

IWbemQuery *pQuery = NULL;

HRESULT hr = NULL;

hr = CoCreateInstance(CLSID_WbemQuery,

                    0,

                    CLSCTX_INPROC_SERVER,

                    IID_IWbemQuery,

                    (LPVOID *)&pQuery);

 

 

hr = pQuery->Parse(L"WQL",

                 L"SELECT * FROM Win32_LogicalDisk WHERE FreeSpace < 4000000L",

                 0);

 

PowerBASIC

 

DIM pQuery AS IWbemQuery

DIM hr AS LONG

pQuery = NEWCOM CLSID $CLSID_WbemQuery

hr = pQuery.Parse(WWQL", _

                "SELECT * FROM Win32_LogicalDisk WHERE FreeSpace < 4000000L", _

                0)

 

备注

 

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。