IWbemPathKeyList::GetKey2 方法 (wmiutils.h)

IWbemPathKeyList::GetKey2 方法检索键名称或值,并将该值作为 VARIANT 返回。 键从 0 (零) 编制索引,但键顺序并不重要。

语法

HRESULT GetKey2(
  [in]      ULONG   uKeyIx,
  [in]      ULONG   uFlags,
  [in, out] ULONG   *puNameBufSize,
  [out]     LPWSTR  pszKeyName,
  [out]     VARIANT *pKeyValue,
  [out]     ULONG   *puApparentCimType
);

参数

[in] uKeyIx

键索引从 0 开始 (零) 。

[in] uFlags

保留。 必须为 0 (零) 。

[in, out] puNameBufSize

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

[out] pszKeyName

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

[out] pKeyValue

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

[out] puApparentCimType

指向设置为 CIM 类型的长整数的指针。

返回值

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

注解

此方法可用于确定需要多大的缓冲区,方法是传入缓冲区的 NULL 指针并将其 size 参数设置为 0 (零) 。 返回时,缓冲区大小参数指示字符串及其 NULL 终止符所需的大小缓冲区。

要求

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

另请参阅

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey