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