描述
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。 |