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 |