SetKey 方法

描述

IWbemPathKeyList.SetKey方法设置一个键的名称或值对。如果密钥存在，则被替换。如果名称为空，则所有现有的键都将被删除。

C++ 语法

HRESULT SetKey(

[in] LPCWSTR wszName,

[in] ULONG uFlags,

[in] ULONG uCimType,

[in] LPVOID pKeyVal

);

PowerBASIC 语法

METHOD SetKey ( _

BYREF wszName AS WSTRINGZ, _

BYVAL uFlags AS DWORD, _

BYVAL uCimType AS DWORD, _

BYVAL pKeyVal AS DWORD _

) AS LONG

参数

wszName

密钥名称可能为NULL。

uFlags

保留。必须为0（零）。

uCimType

CIMTYPE大小。

pKeyVal

指向数据的指针。指向的数据取决于uCimType参数。

返回值

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

退货代码

描述

S_OK

方法成功执行

WBEM_E_INVALID_PARAMETER

三个条件之一：

·	uFlags参数不为0（零）。

·	uCimType参数无效。

·	pKeyVal参数为NULL。

WBEM_E_OUT_OF_MEMORY

内存不足以执行操作。

备注

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。