función CM_Get_DevNode_Registry_PropertyW (cfgmgr32.h)

La función CM_Get_DevNode_Registry_Property recupera una propiedad de dispositivo especificada del Registro.

Sintaxis

CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyW(
  [in]            DEVINST dnDevInst,
  [in]            ULONG   ulProperty,
  [out, optional] PULONG  pulRegDataType,
  [out, optional] PVOID   Buffer,
  [in, out]       PULONG  pulLength,
  [in]            ULONG   ulFlags
);

Parámetros

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[in] ulProperty

Valor constante CM_DRP_ prefijo que identifica la propiedad del dispositivo que se va a obtener del registro. Estas constantes se definen en Cfgmgr32.h.

[out, optional] pulRegDataType

Opcional, puede ser NULL. Puntero a una ubicación que recibe el tipo de datos del Registro, especificado como una constante con prefijo REG_ definida en Winnt.h.

[out, optional] Buffer

Opcional, puede ser NULL. Puntero a un búfer proporcionado por el autor de la llamada que recibe la propiedad de dispositivo solicitada. Si este valor es NULL, la función proporciona solo la longitud de los datos solicitados en la dirección a la que apunta pulLength.

[in, out] pulLength

Puntero a una variable ULONG en la que la función almacena la longitud, en bytes, de la propiedad de dispositivo solicitada.

Si el parámetro Buffer se establece en NULL, la variable ULONG debe establecerse en cero.

Si el parámetro Buffer no está establecido en NULL, la variable ULONG debe establecerse en la longitud, en bytes, del búfer proporcionado por el autor de la llamada.

[in] ulFlags

No se usa, debe ser cero.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error CR_ prefijos definidos en Cfgmgr32.h.

Comentarios

Para obtener información sobre cómo usar identificadores de instancia de dispositivo enlazados al equipo local, consulte CM_Get_Child.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Microsoft Windows 2000.
Plataforma de destino	Universal
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib

Consulte también

CM_Get_Child

CM_Set_DevNode_Registry_Property

SetupDiGetDeviceRegistryProperty