función CM_Get_Class_PropertyW (cfgmgr32.h)
La función CM_Get_Class_Property recupera una propiedad de dispositivo establecida para una clase de interfaz de dispositivo o una clase de configuración de dispositivo.
Sintaxis
CMAPI CONFIGRET CM_Get_Class_PropertyW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Parámetros
[in] ClassGUID
Puntero al GUID que identifica la clase de interfaz de dispositivo o la clase de configuración de dispositivo para la que se va a recuperar una propiedad de dispositivo establecida para la clase de dispositivo. Para obtener información sobre cómo especificar el tipo de clase, vea el parámetro ulFlags .
[in] PropertyKey
Puntero a una estructura DEVPROPKEY que representa la clave de propiedad del dispositivo de la propiedad de clase de dispositivo solicitada.
[out] PropertyType
Puntero a una variable con tipo DEVPROPTYPE que recibe el identificador property-data-type de la propiedad de clase de dispositivo solicitada, donde el identificador property-data-type es el OR bit a bit entre un identificador de tipo de datos base y, si se modifica el tipo de datos base, se modifica un modificador property-data-type.
[out] PropertyBuffer
Puntero a un búfer que recibe la propiedad de clase de dispositivo solicitada. CM_Get_Class_Property recupera el valor de propiedad solicitado solo si el búfer es lo suficientemente grande como para contener todos los datos de valor de propiedad. El puntero puede ser NULL.
[in, out] PropertyBufferSize
Tamaño, en bytes, del búfer PropertyBuffer . Si el parámetro PropertyBuffer se establece en NULL, *PropertyBufferSize debe establecerse en cero. Como salida, si el búfer no es lo suficientemente grande como para contener todos los datos de valor de propiedad, CM_Get_Class_Property devuelve el tamaño de los datos, en bytes, en *PropertyBufferSize.
[in] ulFlags
Marcas de propiedad de clase:
CM_CLASS_PROPERTY_INSTALLER
ClassGUID especifica una clase de configuración de dispositivo. No combine con CM_CLASS_PROPERTY_INTERFACE.
CM_CLASS_PROPERTY_INTERFACE
ClassGUID especifica una clase de interfaz de dispositivo. No combine con CM_CLASS_PROPERTY_INSTALLER.
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 con prefijo CR_ definidos en Cfgmgr32.h.
Comentarios
CM_Get_Class_Property forma parte del modelo de propiedades de dispositivo unificado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | cfgmgr32.h (incluya Cfgmgr32.h) |
| Library | Cfgmgr32.lib |