描述
IWbemPathKeyList.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_QUOTEDTEXT |
在字符串键值周围的地方引用。 |
WBEMPATH_TEXT |
不曾用过。 |
puBuffLength
来电者将此设置为缓冲区可以容纳的字符数。成功后,将其设置为复制到缓冲区中的字符数,包括NULL终止符。
pszText
复制文本的缓冲区。
返回值
此方法返回一个HRESULT,指示方法调用的状态。
退货代码 |
描述 |
S_OK |
方法成功执行 |
WBEM_E_INVALID_PARAMETER |
一个或多个参数无效。 |
WBEM_E_OUT_OF_MEMORY |
内存不足以执行操作。 |
备注
该方法可用于通过传递缓冲区的NULL指针并将其大小参数设置为0(零)来确定需要多大的缓冲区。返回时,缓冲区的大小参数指示字符串及其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。 |