GetKey2 方法

描述

IWbemPathKeyList.GetKey2方法检索密钥名称或值，并返回值为VARIANT.一个密钥从0（零）索引，但密钥顺序不重要。

C++ 语法

HRESULT GetKey2(

[in] ULONG uKeyIx,

[in] ULONG uFlags,

[in, out] ULONG *puNameBufSize,

[out] LPWSTR pszKeyName,

[out] VARIANT *pKeyVal,

[out] ULONG *puApparentCimType

);

PowerBASIC 语法

METHOD GetKey2 ( _

BYVAL uKeyIx AS DWORD, _

BYVAL uFlags AS DWORD, _

BYREF puNameBufSize AS DWORD, _

BYREF pszKeyName AS WSTRINGZ, _

BYREF pKeyVal AS VARIANT, _

BYREF puApparentCimType AS DWORD _

);

参数

uKeyIx

键索引从0开始（零）。

uFlags

保留。必须为0（零）。

puNameBufSize

来电者将此设置为名称缓冲区可以容纳的字符数。成功后，将其设置为复制到包含终止NULL的缓冲区—中的字符数。

pszKeyName

要复制名称的缓冲区。因为并不是所有的键都有一个名称，所以这个参数值对于一个隐式键是NULL。

pKeyVal

指向包含键值的变体的指针。

puApparentCimType

指向长度的指针，设置为CIM类型。

返回值

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

备注

该方法可用于通过传递缓冲区的NULL指针并将其大小参数设置为0（零）来确定需要多大的缓冲区。返回时，buffer size参数指示字符串及其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。