CM_Get_DevNode_Registry_Property function

The CM_Get_DevNode_Registry_Property function retrieves a specified device property from the registry.

Syntax


CMAPI
CONFIGRET
WINAPI CM_Get_DevNode_Registry_Property(
  _In_      DEVINST dnDevInst ,
  _In_      ULONG   ulProperty,
  _Out_opt_ PULONG  pulRegDataType,
  _Out_opt_ PVOID   Buffer,
  _Inout_   PULONG  pulLength,
  _In_      ULONG   ulFlags
);

Parameters

dnDevInst [in]

A caller-supplied device instance handle that is bound to the local machine.

ulProperty [in]

A CM_DRP_-prefixed constant value that identifies the device property to be obtained from the registry. These constants are defined in Cfgmgr32.h.

pulRegDataType [out, optional]

Optional, can be NULL. A pointer to a location that receives the registry data type, specified as a REG_-prefixed constant defined in Winnt.h.

Buffer [out, optional]

Optional, can be NULL. A pointer to a caller-supplied buffer that receives the requested device property. If this value is NULL, the function supplies only the length of the requested data in the address pointed to by pulLength.

pulLength [in, out]

A pointer to a ULONG variable into which the function stores the length, in bytes, of the requested device property.

If the Buffer parameter is set to NULL, the ULONG variable must be set to zero.

If the Buffer parameter is not set to NULL, the ULONG variable must be set to the length, in bytes, of the caller-supplied buffer.

ulFlags [in]

Not used, must be zero.

Return value

If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes that are defined in Cfgmgr32.h.

Remarks

Use SetupDiGetDeviceRegistryProperty instead of CM_Get_DevNode_Registry_Property.

For information about how to use device instance handles that are bound to the local machine, see CM_Get_Child.

Requirements

Target platform

Universal

Version

Available starting with Microsoft Windows 2000.

Header

Cfgmgr32.h (include Cfgmgr32.h)

Library

Cfgmgr32.lib

Unicode and ANSI names

CM_Get_DevNode_Registry_PropertyW (Unicode)

See also

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty

 

 

Send comments about this topic to Microsoft

Show: