CM_Get_DevNode_Registry_PropertyA 函数 (cfgmgr32.h)
CM_Get_DevNode_Registry_Property函数从注册表中检索指定的设备属性。
语法
CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyA(
[in] DEVINST dnDevInst,
[in] ULONG ulProperty,
[out, optional] PULONG pulRegDataType,
[out, optional] PVOID Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
参数
[in] dnDevInst
绑定到本地计算机的调用方提供的设备实例句柄。
[in] ulProperty
一个CM_DRP_前缀的常量值,该值标识要从注册表获取的设备属性。 这些常量在 Cfgmgr32.h 中定义。
[out, optional] pulRegDataType
可选,可以为 NULL。 指向接收注册表数据类型的位置的指针,指定为 Winnt.h 中定义的REG_前缀常量。
[out, optional] Buffer
可选,可以为 NULL。 指向调用方提供的缓冲区的指针,该缓冲区接收请求的设备属性。 如果此值为 NULL,则该函数仅在 pulLength 指向的地址中提供所请求数据的长度。
[in, out] pulLength
指向 ULONG 变量的指针,函数在其中存储所请求设备属性的长度(以字节为单位)。
如果 Buffer 参数设置为 NULL,则必须将 ULONG 变量设置为零。
如果 Buffer 参数未设置为 NULL,则必须将 ULONG 变量设置为调用方提供的缓冲区的长度(以字节为单位)。
[in] ulFlags
未使用,必须为零。
返回值
如果操作成功,函数将返回CR_SUCCESS。 否则,它将返回 Cfgmgr32.h 中定义的CR_前缀错误代码之一。
注解
有关如何使用绑定到本地计算机的设备实例句柄的信息,请参阅 CM_Get_Child。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从 Microsoft Windows 2000 开始可用。 |
目标平台 | 通用 |
标头 | cfgmgr32.h (包括 Cfgmgr32.h) |
Library | Cfgmgr32.lib |
另请参阅
CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty