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

GetText Method

Previous pageReturn to chapter overviewNext page

描述

 

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。