Función SetupDiSetDevicePropertyW (setupapi.h)
La función SetupDiSetDeviceProperty establece una propiedad de instancia de dispositivo.
Sintaxis
WINSETUPAPI BOOL SetupDiSetDevicePropertyW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] const DEVPROPKEY *PropertyKey,
[in] DEVPROPTYPE PropertyType,
[in, optional] const PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in] DWORD Flags
);
Parámetros
[in] DeviceInfoSet
Identificador de un conjunto de información de dispositivo. Este conjunto de información de dispositivo contiene un elemento de información de dispositivo que representa la instancia de dispositivo para la que se va a establecer una propiedad de instancia de dispositivo.
[in] DeviceInfoData
Puntero a la estructura SP_DEVINFO_DATA que identifica la instancia de dispositivo para la que se va a establecer una propiedad de instancia de dispositivo.
[in] PropertyKey
Puntero a una estructura DEVPROPKEY que representa la clave de propiedad del dispositivo de la propiedad de instancia de dispositivo que se va a establecer.
[in] PropertyType
Valor con tipo DEVPROPTYPE que representa el identificador property-data-type para la propiedad de instancia del dispositivo. Para obtener más información, vea la sección Comentarios más adelante en este tema.
[in, optional] PropertyBuffer
Puntero a un búfer que contiene el valor de la propiedad de la instancia de dispositivo. Si la propiedad se elimina o se establece en un valor NULL , este puntero debe ser NULL y PropertyBufferSize debe establecerse en cero.
[in] PropertyBufferSize
Tamaño, en bytes, del búfer PropertyBuffer . Si PropertyBuffer es NULL, PropertyBufferSize debe establecerse en cero.
[in] Flags
Este parámetro debe establecerse en cero.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar llamando a GetLastError.
En la tabla siguiente se incluyen algunos de los códigos de error más comunes que esta función podría registrar.
| Código devuelto | Descripción |
|---|---|
|
El valor de Flags no es cero. |
|
El conjunto de información del dispositivo especificado por DevInfoSet no es válido. |
|
Un parámetro proporcionado no es válido. Una posibilidad es que el elemento de información del dispositivo no sea válido. |
|
La clave de propiedad proporcionada por PropertyKey no es válida o la propiedad no se puede escribir. |
|
El identificador property-data-type proporcionado por PropertyType, o el valor de propiedad proporcionado por PropertyBuffer, no es válido. |
|
Un búfer de usuario no es válido. Una posibilidad es que PropertyBuffer sea NULL y PropertyBufferSize no sea cero. |
|
La instancia de dispositivo especificada por DevInfoData no existe. |
|
Un búfer de datos interno que se pasó a una llamada del sistema era demasiado pequeño. |
|
No había suficiente memoria del sistema disponible para completar la operación. |
|
No se encontró un elemento interno no especificado. Una posibilidad es que la propiedad que se va a eliminar no existe. |
|
El autor de la llamada no tiene privilegios de administrador. |
Comentarios
SetupDiSetDeviceProperty forma parte del modelo de propiedades de dispositivo unificado.
SetupAPI solo admite una versión Unicode de SetupDiSetDeviceProperty.
Un llamador de SetupDiSetDeviceProperty debe ser miembro del grupo Administradores para establecer una propiedad de instancia de dispositivo.
SetupDiSetDeviceProperty exige requisitos en el identificador property-data-type y el valor de propiedad.
Para obtener las claves de propiedad del dispositivo de la instancia que se establecen para un dispositivo, llame a SetupDiGetDevicePropertyKeys.
Para recuperar una propiedad de instancia de dispositivo, llame a SetupDiGetDeviceProperty.
Requisitos
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | DesktopFor universal, call CM_Set_DevNode_Property |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |