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 |