IWbemPathKeyList::GetKey 方法 (wmiutils.h)

IWbemPathKeyList::GetKey 方法检索密钥的名称或值。 键从 0 (零) 编制索引,但键的顺序并不重要。

语法

HRESULT GetKey(
  [in]      ULONG  uKeyIx,
  [in]      ULONG  uFlags,
  [in, out] ULONG  *puNameBufSize,
  [in, out] LPWSTR pszKeyName,
  [in, out] ULONG  *puKeyValBufSize,
  [in, out] LPVOID pKeyVal,
  [in, out] ULONG  *puApparentCimType
);

参数

[in] uKeyIx

从 0 开始的键索引 (零) 。

[in] uFlags

保留。 必须为 0 (零) 。

[in, out] puNameBufSize

调用方将此设置为名称缓冲区可以容纳的字符数。 成功后,此值设置为复制到缓冲区中的字符数,包括终止 NULL。

[in, out] pszKeyName

名称要复制到其中的缓冲区。 由于并非所有键都具有名称,因此对于隐式键,此参数值为 NULL

[in, out] puKeyValBufSize

调用方将此设置为值缓冲区可以容纳的字符数。 成功后,此值设置为复制到缓冲区中的字符数,包括 NULL 终止符。

[in, out] pKeyVal

要在其中复制数据的缓冲区。

[in, out] puApparentCimType

指向设置为 CIM 类型的 long 的指针。

返回值

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

注解

建议的做法是通过调用此方法、传入缓冲区的 NULL 指针并将其 size 参数设置为 0 (零) 来确定需要多大的缓冲区。 返回时,缓冲区的 size 参数指示字符串及其 NULL 终止符所需的缓冲区大小。 然后,可以调用 方法来获取缓冲区值。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wmiutils.h
Library Wbemuuid.lib
DLL Wmiutils.dll

另请参阅

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey2