描述
IWbemPath.GetText方法返回先前已被放入解析器对象的路径的文本表示。
C++ 语法
HRESULT GetText( [in] long lFlags, [in, out] ULONG *puBuffLength, [in, out] LPWSTR pszText ); |
PowerBASIC 语法
METHOD GetText ( _ BYVAL lFlags AS LONG, _ BYREF puBuffLength AS DWORD, _ BYREF pszText AS WSTRINGZ _ ) AS LONG |
参数
lFlags
控制文本返回的标志。
值 |
含义 |
WBEMPATH_COMPRESSED |
已过时。不使用。 |
WBEMPATH_GET_RELATIVE_ONLY |
返回相对路径，跳过服务器和命名空间。 |
WBEMPATH_GET_SERVER_TOO |
返回整个路径，包括服务器和命名空间。 |
WBEMPATH_GET_SERVER_AND_NAMESPACE_ONLY |
仅返回路径的服务器和命名空间部分。忽略课堂或键部分。 |
WBEMPATH_GET_NAMESPACE_ONLY |
仅返回路径的命名空间部分。 |
WBEMPATH_GET_ORIGINAL |
返回使用SetText方法传递的内容。 |
puBuffLength
来电者设置为pszText的大小。如果方法成功，则将puBufferLength设置为使用的广泛字符数，包括终止空字符。
pszText
路径的文字表示。
返回值
此方法返回以下值之一。
退货代码 |
描述 |
S_OK |
方法成功执行 |
WBEM_E_BUFFER_TOO_SMALL |
pszText指向的缓冲区太小，无法容纳文本。 |
WBEM_E_INVALID_PARAMETER |
不好的标志或文字。 |
WBEM_E_OUT_OF_MEMORY |
内存不足以执行操作。 |
备注
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。 |