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