Функция SetupDiSetClassRegistryPropertyA (setupapi.h)

Статья
11/20/2024

Функция SetupDiSetClassRegistryProper ty задает указанное свойство класса устройства в реестре.

Синтаксис

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Параметры

[in] ClassGuid

Указатель на GUID, определяющий класс устройства, для которого необходимо задать свойство.

[in] Property

Значение, определяющее заданное свойство, которое должно быть одним из следующих значений:

SPCRP_CHARACTERISTICS

Вызывающий объект предоставляет флаги, указывающие характеристики устройства для класса. Список флагов характеристик см. в параметре DeviceCharacteristicsIoCreateDevice. Характеристики устройства должны быть заданы при установке класса устройства и не должны быть изменены после установки класса устройства.

SPCRP_DEVTYPE

Вызывающий объект предоставляет тип устройства для класса. Дополнительные сведения см. в разделе Указание типов устройств. Тип устройства следует задать при установке класса устройства и не следует изменять после установки класса устройства.

SPCRP_EXCLUSIVE

Вызывающий объект предоставляет значение DWORD, указывающее, могут ли пользователи получить эксклюзивный доступ к устройствам для этого класса. Предоставленное значение равно 1, если разрешен монопольный доступ или ноль в противном случае. Монопольный параметр для устройства должен быть установлен при установке класса устройства и не должен быть изменен после установки класса устройства.

SPCRP_LOWERFILTERS

(Windows Vista и более поздние версии) Вызывающий объект предоставляет REG_MULTI_SZ список имен служб более низких драйверов фильтров, установленных для класса установки устройства . Дополнительные сведения об установке драйвера фильтра классов см. в разделе Установка драйвера фильтра и INF ClassInstall32 Section.

SPCRP_SECURITY

Вызывающий объект предоставляет дескриптор безопасности устройства в виде SECURITY_DESCRIPTOR структуры в автономном формате (описано в документации по пакету SDK для Microsoft Windows).

SPCRP_SECURITY_SDS

Вызывающий объект предоставляет дескриптор безопасности устройства в виде текстовой строки. Сведения о строках дескриптора безопасности см. вязыка дескриптора безопасности (Windows). Сведения о формате строк дескриптора безопасности см. в разделе "Язык определения дескриптора безопасности" (Windows).

SPCRP_UPPERFILTERS

(Windows Vista и более поздние версии) Вызывающий объект предоставляет REG_MULTI_SZ список имен служб драйверов верхнего фильтра, установленных для класса установки устройства. Дополнительные сведения об установке драйвера фильтра классов см. в разделе Установка драйвера фильтра и INF ClassInstall32 Section.

[in, optional] PropertyBuffer

Указатель на буфер, предоставляющий указанное свойство. Этот параметр является необязательным и может быть null.

[in] PropertyBufferSize

Размер в байтах буфера PropertyBuffer .

[in, optional] MachineName

Указатель на строку, завершающую значение NULL, содержащую имя удаленной системы, для которой необходимо задать указанное свойство класса устройства. Этот параметр является необязательным и может быть null. Если этот параметр имеет значение NULL, свойство задается в имени локальной системы.

Осторожность

Эта функция для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

Reserved

Зарезервировано, должно быть null.

Возвращаемое значение

Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE, а ошибка журнала может быть получена с помощью вызова GetLastError.

Замечания

Вызывающий объект этой функции должен быть членом группы "Администраторы".

Чтобы определить тип данных для свойства класса устройства, вызовите SetupDiGetClassRegistryProperty.

Заметка

Заголовок setupapi.h определяет SetupDiSetClassRegistryProperty как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows XP и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty

Поделиться через